Fixes: NB#206058 - Sometimes MSceneWindow uses the landscape style even when the MWindow has been locked to portrait

RevBy: TrustMe
Details: Documentation update for MWindow. MSceneManager has to
recalculate orientation angle (re-request it from MOrientationTracker)
in its constructor in order to rotate the scene root element correctly
for standard MApplicationWindow-based applications.
Any MWindow-based application that is going to use MSceneManager should
set a scene manager for window before performing any orientation angle
operations.

1 files changed, 16 insertions, 4 deletions

diff --git a/src/corelib/widgets/mwindow.h b/src/corelib/widgets/mwindow.h
index d80aa9fd..eb6a6dfc 100644
--- a/src/corelib/widgets/mwindow.h
+++ b/src/corelib/widgets/mwindow.h
@@ -108,10 +108,11 @@ public:
 
      \a parent is passed to QGraphicsView's constructor.
 
-     A scene manager can be assigned later by calling setSceneManager(),
-     however a default scene manager will be automatically created as
-     needed unless explicitly set whenever any scene management is required
-     (adding a managed class like MDialog to the application).
+     By default MWindow doesn't create a scene manager. It can be assigned
+     later by calling setSceneManager(). Also, a default scene manager
+     will be automatically created as needed unless explicitly set whenever
+     any scene management is required (adding a managed class like MDialog
+     to the application).
 
      \sa setSceneManager(), sceneManager()
      */
@@ -220,6 +221,11 @@ public:
      \a sceneManager. The new \a sceneManager can be 0.
 
      MWindow will take ownership of the given scene manager.
+
+     \note  Scene manager takes over orientation angle management of a window.
+            If window orientation angle was changed manually before creating
+            a scene manager, the scene manager will override this setting.
+
      */
     void setSceneManager(MSceneManager *sceneManager);
 
@@ -239,6 +245,12 @@ public:
      The scene manager is responsible for positioning, animating and
      generally managing MSceneWindows such as MDialog and MApplicationPage
      inside the window's scene.
+
+     \note  Scene manager takes over orientation angle management of a window.
+            If window orientation angle was changed manually before creating
+            a scene manager, the scene manager will override this setting.
+
+     \sa setSceneManager()
      */
     MSceneManager *sceneManager();