×
Namespaces

Variants
Actions
(Difference between revisions)

Archived:Handle change in screen orientation in Qt

From Nokia Developer Wiki
Jump to: navigation, search
hamishwillee (Talk | contribs)
m (Hamishwillee - Addition to article of: Category:MeeGo Category:Symbian. (Add platform categories))
hamishwillee (Talk | contribs)
m (Text replace - "<code cpp>" to "<code cpp-qt>")
(4 intermediate revisions by one user not shown)
Line 1: Line 1:
[[Category:QWidget UI]][[Category:UI]][[Category:Code Examples]]
 
{{Abstract|This code example shows how to get notification when the screen mode changes using [http://doc.qt.nokia.com/stable/qwidget.html#resizeEvent QWidget::resizeEvent()]. This method gets called when the screen mode changes, so you have to implement that virtual method in your class in order to handle orientation change events.}}
 
 
{{Archived|timestamp=20120213040924|user=[[User:Hamishwillee|&lt;br /&gt;----]]|[[:Category:Qt Quick|Qt Quick]] should be used for all UI development on mobile devices. The approach described in this article (based on {{Qapiname|QWidget}}) is deprecated.}}
 
{{Archived|timestamp=20120213040924|user=[[User:Hamishwillee|&lt;br /&gt;----]]|[[:Category:Qt Quick|Qt Quick]] should be used for all UI development on mobile devices. The approach described in this article (based on {{Qapiname|QWidget}}) is deprecated.}}
{{ArticleMetaData <!-- v1.1 -->
+
[[Category:Qt C++ UI]][[Category:UI]][[Category:Code Examples]]
|sourcecode= [[Media:QtResizeEvent.zip]]  
+
{{Abstract|This code example shows how to get notification when the screen mode changes using [http://doc.qt.nokia.com/stable/qwidget.html#resizeEvent QWidget::resizeEvent()]. This method gets called when the screen mode changes, so you have to implement that virtual method in your class in order to handle orientation change events.}}
 +
{{ArticleMetaData <!-- v1.2 -->
 +
|sourcecode= [[Media:QtResizeEvent.zip]]
 
|installfile= <!-- Link to installation file (e.g. [[Media:The Installation File.sis]]) -->
 
|installfile= <!-- Link to installation file (e.g. [[Media:The Installation File.sis]]) -->
 
|devices= Nokia 5800 XpressMusic
 
|devices= Nokia 5800 XpressMusic
Line 13: Line 13:
 
|capabilities= None
 
|capabilities= None
 
|keywords= QWidget::resizeEvent()
 
|keywords= QWidget::resizeEvent()
|id= <!-- Article Id (Knowledge base articles only) -->
 
 
|language= <!-- Language category code for non-English topics - e.g. Lang-Chinese -->
 
|language= <!-- Language category code for non-English topics - e.g. Lang-Chinese -->
 
|translated-by= <!-- [[User:XXXX]] -->
 
|translated-by= <!-- [[User:XXXX]] -->
Line 38: Line 37:
 
==Source==
 
==Source==
  
<code cpp>
+
<code cpp-qt>
 
//resizeEvent() method get called when user change screen mode.
 
//resizeEvent() method get called when user change screen mode.
 
void ResizeEvent::resizeEvent (QResizeEvent* event)
 
void ResizeEvent::resizeEvent (QResizeEvent* event)
Line 54: Line 53:
  
 
'''Normal screen'''<br><br>
 
'''Normal screen'''<br><br>
[[Image:ResizeEvent2.JPG]]
+
[[File:ResizeEvent2.JPG]]
  
 
'''Screen after changing mode to portrait'''<br><br>
 
'''Screen after changing mode to portrait'''<br><br>
[[Image:ResizeEvent1.JPG]]
+
[[File:ResizeEvent1.JPG]]
  
 
==Related link==
 
==Related link==
* [[CS001437 - Listening for screen orientation changes in Qt]]
+
* [[Archived:Listening for screen orientation changes in Qt]]
  
 
==Download Code Example==
 
==Download Code Example==
  
 
* [[File:QtResizeEvent.zip]] shows new screen size when user change screen mode. This example is tested on Nokia 5800 XpressMusic.
 
* [[File:QtResizeEvent.zip]] shows new screen size when user change screen mode. This example is tested on Nokia 5800 XpressMusic.
<br>[[Category:MeeGo]] [[Category:Symbian]]
+
<br>[[Category:MeeGo Harmattan]] [[Category:Symbian]]

Revision as of 04:14, 11 October 2012

Archived.pngArchived: This article is archived because it is not considered relevant for third-party developers creating commercial solutions today. If you think this article is still relevant, let us know by adding the template {{ReviewForRemovalFromArchive|user=~~~~|write your reason here}}.

Qt Quick should be used for all UI development on mobile devices. The approach described in this article (based on QWidget) is deprecated.

This code example shows how to get notification when the screen mode changes using QWidget::resizeEvent(). This method gets called when the screen mode changes, so you have to implement that virtual method in your class in order to handle orientation change events.

Article Metadata
Code ExampleTested with
Devices(s): Nokia 5800 XpressMusic
Compatibility
Platform(s): S60 3rd Edition, FP1, FP2
S60 5th Edition
Symbian
Platform Security
Signing Required: Self-Signed
Capabilities: None
Article
Keywords: QWidget::resizeEvent()
Created: savaj (26 Jun 2009)
Last edited: hamishwillee (11 Oct 2012)

Warning.pngWarning: This article does not work properly in Qt 4.7 in Symbian. It can be rectified with the change described below.

The issue is in the example code's ResizeEvent::GetScreenCoordinates() method. The GetScreenCoordinates uses QDesktopWidget::availableGeometry and QDesktopWidget::screenGeometry methods. In all cases these methods do not reflect current screen geometry values during QWidget::resizeEvent call as the respective values are only changed after the resizeEvent has occured. This means that e.g. during the startup of the application these may return wrong values as the values are not yet set properly.

If the whole screen geometry information is needed from QDesktopWidget it's advised to connect to QApplication::desktop()'s workAreaResized(int) signal and call QApplication::desktop()->availableGeometry() in the connected slot function. This works in Qt 4.7.3 in Symbian but not (due to bug) in Qt 4.6.

See following bug report for more details. The QTBUG-14058's fix introduces documentation for QDesktopWidget on this issue.

In many cases application should however get simply the geometry of the main window using QMainWindow::width() and ::height() methods during QMainWindow's resizeEvent.

Contents

Source

//resizeEvent() method get called when user change screen mode.
void ResizeEvent::resizeEvent (QResizeEvent* event)
{
QSize widgetSize = event->size();
//Resize your custom control according to new size.
QMainWindow::resizeEvent(event);
}

Postconditions

The code snippet is expected to notify change in screen mode.

Normal screen

ResizeEvent2.JPG

Screen after changing mode to portrait

ResizeEvent1.JPG

Related link

Download Code Example

  • File:QtResizeEvent.zip shows new screen size when user change screen mode. This example is tested on Nokia 5800 XpressMusic.


117 page views in the last 30 days.