ApplicationWindow QML Type

ヘッダーとフッターをサポートするスタイル付きトップレベル・ウィンドウ。詳細...

Import Statement: import QtQuick.Controls
Inherits:

Window

プロパティ

付属物件

詳細説明

ApplicationWindowはWindow 、ウィンドウにmenu barheaderfooter アイテムを追加するのに便利です。

ApplicationWindowをアプリケーションのルートアイテムとして宣言し、QQmlApplicationEngine 。このようにして、QMLからウィンドウのプロパティ、外観、レイアウトを制御することができます。

import QtQuick.Controls 2.12

ApplicationWindow {
    visible: true

    menuBar: MenuBar {
        // ...
    }

    header: ToolBar {
        // ...
    }

    footer: TabBar {
        // ...
    }

    StackView {
        anchors.fill: parent
    }
}

注意: デフォルトでは、ApplicationWindowは表示されません。

ApplicationWindowのプロパティ

QMLのスコープと命名解決(Scope and Naming Resolution)の仕組みにより、子要素であるQMLオブジェクトのどこにいても、アプリケーションルート要素(id )を参照することができます。この方法は、多くのアプリケーションや使用例では問題ありませんが、 一般的なQMLコンポーネントでは、周囲の環境に依存することになるため、 受け入れられない場合があります。

idApplicationWindowは、ウィンドウへの直接アクセスが不可能な場所から、 ウィンドウとその構成要素にアクセスするための付属プロパティを提供します。ApplicationWindowの付属プロパティを使用するQMLコンポーネントは、id に関係なく、どのウィンドウでも動作します。

安全な領域

Qt 6.9 以降、ApplicationWindow は、ウィンドウから報告されたsafe area margins に対して、自動的にcontentItem にパディングを追加します。これにより、contentItem がウィンドウの安全領域内に留まり、背景アイテムがウィンドウ全体を覆うようになります。

ウィンドウのcontentItem で安全領域のマージンを手動で指定している場合は、topPaddingleftPaddingrightPaddingbottomPadding プロパティでデフォルトをオーバーライドできます:

ApplicationWindow {
    // Remove automatic safe area padding
    topPadding: 0

    Flickable {
        // Inset content by safe area margin
        topMargin: SafeArea.margins.top
    }
}

header,footer,menuBar プロパティは、安全領域マージンのための自動パディングを受け取りません。ただし、使用するスタイルによっては、ToolBarTabBarMenuBar の実装で安全領域が考慮される場合があります。

ApplicationWindow のカスタマイズOverlayPageコンテナ・コントロール Qt Quick コントロールのフォーカス管理も参照してください

プロパティ ドキュメント

activeFocusControl : Control [read-only]

このプロパティは、現在アクティブなフォーカスを持つコントロールを保持し、アクティブなフォーカスを持つコントロールがない場合はnull を保持します。

Window::activeFocusItemApplicationWindow::activeFocusControl の違いは、前者がコントロールのビルディングブロックを指すことがあるのに対し、後者はそれを囲むコントロールを指すことである。例えば、SpinBox にフォーカスがある場合、activeFocusItem はエディタを指し、activeFocusControl はSpinBox 自体を指します。

Window::activeFocusItemも参照してください


background : Item

このプロパティは背景アイテムを保持します。

背景アイテムは、content item の下にスタックされますが、ウィンドウのbackground color の上にスタックされます。

背景項目は、画像やグラデーションなどに便利ですが、color プロパティは、項目を作成する必要がないため、無地の色に適しています。

注意: 背景アイテムに明示的なサイズが指定されていない場合、コントロールのサイズに自動的に従います。ほとんどの場合、背景アイテムの幅や高さを指定する必要はありません。

ApplicationWindowのカスタマイズcontentItemheaderfooterも参照してください


bottomPadding : real [since 6.9]

このプロパティは、ウィンドウのコンテンツアイテムのボトムパディングを保持する。明示的に設定しない限り、値はウィンドウのsafe area margins を反映します。

このプロパティは Qt 6.9 で導入されました。

topPadding,leftPadding,rightPaddingも参照してください


contentData : list<QtObject> [default]

このデフォルト・プロパティは、ウィンドウの子として宣言されたすべてのオブジェクトのリストを保持します。

data プロパティを使用すると、ApplicationWindow 内で、ビジュアルチルドレン、リソース、他のウィンドウを自由に混在させることができます。

アイテムを contentData リストに割り当てる と、そのアイテムはウィンドウの子contentItem になり、ウィンドウの内側に表示されます。アイテムの親はウィンドウのcontentItem になります。

contentDataプロパティは、ApplicationWindow のデフォルト・プロパティであり、すべての子アイテムは自動的にこのプロパティに割り当てられるため、一般的には参照する必要はありません。

contentItemも参照のこと


contentItem : Item [read-only]

このプロパティはウィンドウ内容項目を保持する。

コンテンツ項目は、background 項目の上、menuBarheaderfooter 項目の下にスタックされます。

Qt 6.9 以降、ApplicationWindow は、ウィンドウから報告されたsafe area margins の contentItem に自動的にパディングを追加します。パディングをオーバーライドするには、個々のパディング・プロパティを使用します。

background,menuBar,header,footer,topPadding,bottomPadding,leftPadding,rightPaddingも参照してください


font : font

このプロパティは、ウィンドウに現在設定されているフォントを保持します。

デフォルト・フォントはシステム環境に依存します。QGuiApplication は、すべてのアプリケーション・ウィンドウのデフォルトとなるシステム/テーマ・フォントを保持します。QML を読み込む前にQGuiApplication::setFont() にカスタムフォントを渡すことで、ウィンドウのデフォルトフォントを設定することもできます。最後に、フォントは Qt のフォントデータベースと照合され、最適なものが見つかります。

ApplicationWindow は、明示的なフォントプロパティを子コントロールに伝達します。ウィンドウのフォントの特定のプロパティを変更すると、そのプロパティはウィンドウ内のすべての子コントロールに伝わり、そのプロパティのシステムデフォルトを上書きします。

Control::fontも参照のこと


このプロパティはウィンドウのフッター項目を保持する。フッター項目は一番下に配置され、ウィンドウの幅にリサイズされます。デフォルト値はnull です。

ApplicationWindow {
    footer: ToolBar {
        // ...
    }
}

注: ToolBarTabBarDialogButtonBox をウィンドウ・フッターとして割り当てると、それぞれのToolBar::positionTabBar::positionDialogButtonBox::position プロパティが自動的にFooter に設定されます。

menuBarheaderPage::footerも参照してください


header : Item

このプロパティはウィンドウヘッダー項目を保持する。ヘッダー項目はウィンドウの上部、メニュー・バーの下に配置され、ウィンドウの幅にリサイズされる。デフォルト値はnull です。

ApplicationWindow {
    header: TabBar {
        // ...
    }
}

注: ToolBarTabBarDialogButtonBox をウィンドウ・ヘッダーとして割り当てると、それぞれのToolBar::positionTabBar::positionDialogButtonBox::position プロパティが自動的にHeader に設定されます。

menuBar,footer,Page::headerも参照


leftPadding : real [since 6.9]

このプロパティは、ウィンドウのコンテンツ項目の左パディングを保持する。明示的に設定しない限り、値はウィンドウのsafe area margins を反映します。

このプロパティは Qt 6.9 で導入されました。

bottomPaddingtopPaddingrightPaddingも参照してください


locale : Locale

このプロパティは、ウィンドウのロケールを保持します。

デフォルトのロケールはシステム環境に依存します。QML を読み込む前にQLocale::setDefault() を呼び出すことで、デフォルトのロケールを設定することができます。

ApplicationWindow を呼び出すと、ロケールが子コントロールに伝搬されます。ウィンドウのロケールを変更すると、そのロケールはウィンドウ内のすべての子コントロールに伝わり、システムのデフォルトロケールを上書きします。

Control::localeも参照してください


このプロパティはウィンドウのメニューバーを保持する。メニューバーはウィンドウの上部、ヘッダーの上に配置され、ウィンドウの幅に合わせてリサイズされます。デフォルト値はnull です。

ApplicationWindow {
    menuBar: MenuBar {
        // ...
    }
}

このプロパティは QtQuick.Controls 2.3 (Qt 5.10) で導入されました。

header,footer,MenuBarも参照してください


rightPadding : real [since 6.9]

このプロパティは、ウィンドウのコンテンツ項目の右パディングを保持します。明示的に設定しない限り、値はウィンドウのsafe area margins を反映します。

このプロパティは Qt 6.9 で導入されました。

bottomPadding,leftPadding,topPaddingも参照してください


topPadding : real [since 6.9]

このプロパティは、ウィンドウのコンテンツアイテムのトップパディングを保持します。明示的に設定されない限り、値はウィンドウのsafe area margins を反映します。

このプロパティは Qt 6.9 で導入されました。

bottomPadding,leftPadding,rightPaddingも参照してください


Attached プロパティの説明

ApplicationWindow.activeFocusControl : Control [read-only]

この Attached プロパティは、現在アクティブなフォーカスを持つコントロールを保持し、アクティブなフォーカスを持つコントロールがない場合はnull を保持します。このプロパティは、どのアイテムにもアタッチすることができる。アイテムがウィンドウ内にないか、ウィンドウにアクティブフォーカスがない場合、値はnull となる。

Window::activeFocusItemAttached ApplicationWindow Propertiesも参照のこと


ApplicationWindow.contentItem : Item [read-only]

この付属プロパティはウィンドウ内容項目を保持する。このプロパティはどの項目にも付けることができる。アイテムがApplicationWindow にない場合、値はnull となる。

Attached ApplicationWindow Propertiesも参照


この付属プロパティはウィンドウフッター項目を保持する。このプロパティはどの項目にも付けることができる。項目がApplicationWindow にない場合、またはウィンドウにフッター項目がない場合、値はnull となる。

Attached ApplicationWindow Propertiesも参照のこと


ApplicationWindow.header : Item [read-only]

この付属プロパティはウィンドウヘッダー項目を保持する。このプロパティはどの項目にも付けることができる。項目がApplicationWindow にない場合、またはウィンドウにヘッダ項目がない場合、値はnull となる。

Attached ApplicationWindow Propertiesも参照のこと


この付属プロパティはウィンドウメニューバーを保持する。このプロパティはどの項目にもアタッチできる。アイテムがApplicationWindow にない場合、またはウィンドウにメニュー・バーがない場合、値はnull になります。

このプロパティは QtQuick.Controls 2.3 (Qt 5.10) で導入されました。

Attached ApplicationWindow Propertiesも参照してください


ApplicationWindow.window : ApplicationWindow [read-only]

このアタッチされたプロパティは、アプリケーション・ウィンドウを保持します。このプロパティは、任意のアイテムにアタッチすることができます。アイテムがApplicationWindow にない場合、値はnull になります。

Attached ApplicationWindow Propertiesも参照して ください。


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.