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 に関係なく、どのウィンドウでも動作します。

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

プロパティの説明

activeFocusControl : Control [read-only]

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

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

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


background : Item

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

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

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

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

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


contentData : list<QtObject> [default]

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

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

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

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

contentItemも参照のこと


contentItem : Item [read-only]

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

内容項目は、background 項目の上、menuBarheaderfooter 項目の下にスタックされる。

background,menuBar,header,footerも参照のこと


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 に設定されます。

menuBarfooterPage::headerも参照


locale : Locale

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

デフォルトのロケールはシステム環境に依存する。デフォルトのロケールを設定するには、QMLをロードする前にQLocale::setDefault() を呼び出します。

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

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


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

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

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

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


Attached Property ドキュメント

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.