MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

QML PageStackWindow Element

Default window for all MeeGo 1.2 Harmattan applications More...

Inherits Window

Inherited by ApplicationWindow.

This element was introduced in qt-components 4.7.


Detailed Description

Applications are constructed using the MeeGo 1.2 Harmattan-specific PageStackWindow that brings the page navigation, toolbar, statusbar and platform common look and feel.

The developer achieves all the functionality of the PageStackWindow by separately using elements and placing them inside the Window element. However, it is recomended to use the PageStackWindow so that correct platform UI is achieved.

 import QtQuick 1.1
 import 1.1

 PageStackWindow {
     showStatusBar: false
     initialPage: MainPage { }

A good example how PageStackWindow is used is found from the MeeGo 1.2 Harmattan example QmlComponentGallery or the Simple tutorial application that is found from front page of API documentation.

Note that the PageStackWindow as it is now defined is a MeeGo 1.2 Harmattan-specific element.

Property Documentation

initialPage : variant

Initial page in the PageStack of the PageStackWindow. To ensure safe memory cleanup it is recommend to use Component here as opposed to Item.

pageStack : PageStack

PageStack managed by the PageStackWindow.

platformStyle : Style

Platform specific styling for the PageStackWindow. Currently only available option is PageStackWindowStyle that gives the platform look and feel. That is also the default value of the platformStyle property.

See also PageStackWindowStyle.

platformToolBarHeight : real

This read-only property provides height of ToolBar. Can be used e.g. to set page's bottom margin, when toolbar is not shown, to prevent toolbar from hiding content (e.g. when unfocusing TextField in bottom of page).

showStatusBar : bool

Defines whether the system status bar be shown or not. The default value is true.

showToolBar : bool

Defines whether the tool bar be shown or not. The default value is true.