Qt Reference Documentation

QML PageStackWindow Element

Provides a main window for the application. More...

Inherits Window

This element was introduced in Qt Quick Components 1.1.


Detailed Description

Applications can be constructed using the PageStackWindow that brings the page navigation, statusbar, toolbar, and platform's common look and feel.

Using PageStackWindow

The example below shows how to construct an application with the PageStackWindow. It disables the system's status bar leaving more screen area for the application's content and initializes the application's main page on the application's startup.

 import QtQuick 1.1
 import com.nokia.Symbian 1.1

 PageStackWindow {
     showStatusBar: false
     initialPage: MainPage {}

See also the Gallery demo application that shows a concrete example how PageStackWindow is used.

Property Documentation

content : list<Object>

With this property you can set the child objects of the visual content area of the PageStackWindow. The content area fills the area between the StatusBar and ToolBar components. Note that this content is not visible when any page is active.

initialPage : variant

Sets the initial page of the PageStack. This can be a Page instance, a component, or an array. Once the construction is completed, the value will be pushed onto the stack.

With this property you can only set the root page of the stack. In other words, if there are pages on the stack, changing the initialPage has no effect.

See also PageStack::push.

pageStack : PageStack

PageStack managed by the PageStackWindow.

platformSoftwareInputPanelEnabled : bool

Defines whether the PageStackWindow's content area size is adjusted to accommodate the software input panel or not. The size is adjusted when the value is true; otherwise not.

The default value is false.

showStatusBar : bool

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

showToolBar : bool

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