diff options
| author | Fabian Bumberger <fbumberger@rim.com> | 2014-02-14 12:03:52 +0100 |
|---|---|---|
| committer | The Qt Project <gerrit-noreply@qt-project.org> | 2014-02-14 15:10:08 +0100 |
| commit | d72630c2ecb412d4776e75b043552f5626de85a5 (patch) | |
| tree | 064a99f042ecb9527a4ffedb1be19b8207044f22 /src/gui | |
| parent | 3dc1ccc18328773c6d866ad2b56d819cb23b8d4a (diff) | |
Extend the documentation for orientation in QScreen
I find the current description of primaryOrientation and orientation
a bit confusing.
Change-Id: I25d77cff2c27c481607903bc1aeb54eacf616718
Reviewed-by: Laszlo Agocs <laszlo.agocs@digia.com>
Diffstat (limited to 'src/gui')
| -rw-r--r-- | src/gui/kernel/qscreen.cpp | 11 |
1 files changed, 8 insertions, 3 deletions
diff --git a/src/gui/kernel/qscreen.cpp b/src/gui/kernel/qscreen.cpp index 2573f76374..70ee631fc8 100644 --- a/src/gui/kernel/qscreen.cpp +++ b/src/gui/kernel/qscreen.cpp @@ -401,8 +401,8 @@ Qt::ScreenOrientations QScreen::orientationUpdateMask() const The screen orientation represents the physical orientation of the display. For example, the screen orientation of a mobile device - will change based on the device is being held, and a desktop display - might be rotated so that it's in portrait mode. + will change based on how it is being held. A change to the orientation + might or might not trigger a change to the primary orientation of the screen. Changes to this property will be filtered by orientationUpdateMask(), so in order to receive orientation updates the application must first @@ -435,7 +435,12 @@ qreal QScreen::refreshRate() const The primary screen orientation is Qt::LandscapeOrientation if the screen geometry's width is greater than or equal to its - height, or Qt::PortraitOrientation otherwise. + height, or Qt::PortraitOrientation otherwise. This property might + change when the screen orientation was changed (i.e. when the + display is rotated). + The behavior is however platform dependent and can often be specified in + an application manifest file. + */ Qt::ScreenOrientation QScreen::primaryOrientation() const { |