Qt Reference Documentation

QML ApplicationWindow Element

Provides a view template that contains several UI elements. More...

Inherits Window

  • List of all members, including inherited members
  • Properties

    Detailed Description

    Creates an easy-to-use view that has Window, StatusBar, ToolBar, and PageStack components. This component provides convenience properties that place child components into correct layouts.

    Note: This component is experimental, so it may be changed or removed in future releases.

    Using ApplicationWindow

    The example below illustrates the ApplicationWindow component's basic usage. The window contains a root Page object which contains a CheckBox. The CheckBox controls the ApplicationWindow's fullScreen property. Setting the ToolBarLayout to the Page's tools property enables the back button in the ToolBar.

     import QtQuick 1.0
     import com.nokia.symbian 1.0
    
     ApplicationWindow
     {
         id: window
         fullScreen: checkBox.checked
    
         Page {
             id: rootPage
             tools: applicationTools
             CheckBox {
                 id: checkBox
                 anchors.horizontalCenter: parent.horizontalCenter
                 anchors.verticalCenter: parent.verticalCenter
             }
         }
    
         ToolBarLayout {
             id: applicationTools
             ToolButton {
                 flat: true
                 iconSource: "toolbar-back"
                 onClicked: window.pageStack.depth <= 1 ? Qt.quit() : window.pageStack.pop()
             }
         }
    
         Component.onCompleted: window.pageStack.push(rootPage)
     }

    Property Documentation

    defaultcontent : list<QtObject>

    Enables the application content to be placed directly as a child of ApplicationWindow. The items in ApplicationWindow are laid out between the StatusBar and ToolBar components. Usually you do not need to directly access this property. However, if you create objects dynamically into the application content area, you should use this property as the parent of created objects.


    read-onlyfullScreen : bool

    Defines how the application content area fills the screen. If the property is true, the application content area fills the whole screen. If the property is false, the StatusBar and ToolBar components are visible and the application content area fills the area between the StatusBar and ToolBar components.

    The default value is false.


    pageStack : PageStack

    A convenience property provided by ApplicationWindow. The application does not have to use it.