ApplicationWindow QML Type
ヘッダーとフッターをサポートするスタイル付きトップレベル・ウィンドウ。詳細...
Import Statement: | import QtQuick.Controls |
Inherits: |
プロパティ
- activeFocusControl : Control
- background : Item
- contentData : list<QtObject>
- contentItem : Item
- font : font
- footer : Item
- header : Item
- locale : Locale
- menuBar : Item
(since QtQuick.Controls 2.3 (Qt 5.10))
付属プロパティ
- activeFocusControl : Control
- contentItem : Item
- footer : Item
- header : Item
- menuBar : Item
(since QtQuick.Controls 2.3 (Qt 5.10))
- window : ApplicationWindow
詳細説明
ApplicationWindowはWindow 、ウィンドウにmenu bar 、header 、footer アイテムを追加するのに便利です。
アプリケーションのルート・アイテムとして 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コンポーネントでは、周囲の環境に依存することになるため、 受け入れられない場合があります。
id
ApplicationWindowは、ウィンドウへの直接アクセスが不可能な場所から、 ウィンドウとその構成要素にアクセスするための付属プロパティを提供します。ApplicationWindowの付属プロパティを使用するQMLコンポーネントは、id
に関係なく、どのウィンドウでも動作します。
Qt Quick Controls のApplicationWindow のカスタマイズ、Overlay 、Page 、コンテナコントロール、フォーカス管理も参照してください 。
プロパティ ドキュメント
activeFocusControl : Control |
このプロパティは、現在アクティブなフォーカスを持つコントロールを保持します。アクティブなフォーカスを持つコントロールがない場合は、null
。
Window::activeFocusItem とApplicationWindow::activeFocusControl の違いは、前者がコントロールのビルディングブロックを指すことがあるのに対し、後者はそれを囲むコントロールを指すことです。例えば、SpinBox にフォーカスがある場合、activeFocusItem はエディタを指し、activeFocusControl はSpinBox 自体を指します。
Window::activeFocusItemも参照してください 。
background : Item |
このプロパティは背景アイテムを保持します。
背景アイテムは、content item の下にスタックされますが、ウィンドウのbackground color の上にスタックされます。
背景項目は、例えば画像やグラデーションの場合に便利ですが、color プロパティは、項目を作成する必要がないため、無地の場合に適しています。
注意: 背景アイテムに明示的なサイズが指定されていない場合、コントロールのサイズに自動的に従います。ほとんどの場合、背景アイテムの幅や高さを指定する必要はありません。
ApplicationWindowのカスタマイズ、contentItem 、header 、footerも参照してください 。
このデフォルト・プロパティは、ウィンドウの子として宣言されたすべてのオブジェクトのリストを保持します。
データプロパティを使用すると、ビジュアルチルドレン、リソース、他のウィンドウをApplicationWindow に自由に混在させることができます。
アイテムを contentData リストに割り当てる と、そのアイテムはウィンドウの子contentItem になり、ウィンドウの内側に表示されます。アイテムの親はウィンドウのcontentItem になります。
contentDataプロパティはApplicationWindow のデフォルト・プロパティであり、すべての子アイテムは自動的にこのプロパティに割り当てられるため、一般的には参照する必要はありません。
contentItemも参照のこと 。
contentItem : Item |
このプロパティはウィンドウ内容項目を保持する。
内容項目は、background 項目の上、menuBar 、header 、footer 項目の下にスタックされる。
background,menuBar,header,footerも参照のこと 。
font : font |
このプロパティは、ウィンドウに現在設定されているフォントを保持する。
デフォルト・フォントはシステム環境によって異なります。QGuiApplication は、すべてのアプリケーション・ウィンドウのデフォルトとして機能するシステム/テーマ・フォントを保持します。QML を読み込む前にQGuiApplication::setFont() にカスタムフォントを渡すことで、ウィンドウのデフォルトフォントを設定することもできます。最後に、フォントは Qt のフォントデータベースと照合され、最適なものが見つかります。
ApplicationWindow は、明示的なフォントプロパティを子コントロールに伝達します。ウィンドウのフォントの特定のプロパティを変更すると、そのプロパティはウィンドウ内のすべての子コントロールに伝わり、そのプロパティのシステムデフォルトを上書きします。
Control::fontも参照のこと 。
footer : Item |
このプロパティはウィンドウのフッター項目を保持する。フッター項目は一番下に配置され、ウィンドウの幅にリサイズされます。デフォルト値はnull
です。
ApplicationWindow { footer: ToolBar { // ... } }
注: ToolBar 、TabBar 、DialogButtonBox をウィンドウ・フッターとして割り当てると、それぞれのToolBar::position 、TabBar::position 、DialogButtonBox::position プロパティが自動的にFooter
に設定されます。
menuBar 、header 、Page::footerも参照してください 。
header : Item |
このプロパティはウィンドウヘッダー項目を保持する。ヘッダー項目はウィンドウの上部、メニュー・バーの下に配置され、ウィンドウの幅にリサイズされる。デフォルト値はnull
です。
ApplicationWindow { header: TabBar { // ... } }
注: ToolBar 、TabBar 、DialogButtonBox をウィンドウ・ヘッダーとして割り当てると、それぞれのToolBar::position 、TabBar::position 、DialogButtonBox::position プロパティが自動的にHeader
に設定されます。
menuBar 、footer 、Page::headerも参照 。
locale : Locale |
このプロパティはウィンドウのロケールを保持する。
デフォルトのロケールはシステム環境に依存する。デフォルトのロケールを設定するには、QMLをロードする前にQLocale::setDefault() を呼び出します。
ApplicationWindow を呼び出すと、ロケールが子コントロールに伝搬されます。ウィンドウのロケールを変更すると、そのロケールはウィンドウ内のすべての子コントロールに伝わり、システムのデフォルトロケールを上書きします。
Control::localeも参照してください 。
menuBar : Item |
このプロパティはウィンドウのメニューバーを保持する。メニューバーはウィンドウの上部、ヘッダーの上に配置され、ウィンドウの幅に合わせてリサイズされます。デフォルト値はnull
です。
ApplicationWindow { menuBar: MenuBar { // ... } }
このプロパティは、QtQuick.Controls 2.3(Qt 5.10)で導入されました。
Attached Property ドキュメント
ApplicationWindow.activeFocusControl : Control |
この Attached プロパティは、現在アクティブなフォーカスを持つコントロールを保持し、アクティブなフォーカスを持つコントロールがない場合はnull
を保持します。このプロパティは、どのアイテムにもアタッチすることができる。アイテムがウィンドウ内にないか、ウィンドウにアクティブフォーカスがない場合、値はnull
となる。
Window::activeFocusItem とAttached ApplicationWindow Propertiesも参照のこと 。
ApplicationWindow.contentItem : Item |
この付属プロパティはウィンドウ内容項目を保持する。このプロパティはどの項目にも付けることができる。アイテムがApplicationWindow にない場合、値はnull
となる。
ApplicationWindow.footer : Item |
この付属プロパティはウィンドウフッター項目を保持する。このプロパティはどの項目にも付けることができる。項目がApplicationWindow にない場合、またはウィンドウにフッター項目がない場合、値はnull
となる。
ApplicationWindow.header : Item |
この付属プロパティはウィンドウヘッダー項目を保持する。このプロパティはどの項目にも付けることができる。項目がApplicationWindow にない場合、またはウィンドウにヘッダ項目がない場合、値はnull
となる。
ApplicationWindow.menuBar : Item |
この付属プロパティはウィンドウメニューバーを保持する。このプロパティはどの項目にもアタッチできる。アイテムがApplicationWindow にない場合、またはウィンドウにメニュー・バーがない場合、値はnull
になります。
このプロパティは QtQuick.Controls 2.3 (Qt 5.10) で導入されました。
Attached ApplicationWindow Propertiesも参照してください 。
ApplicationWindow.window : ApplicationWindow |
このアタッチされたプロパティは、アプリケーション・ウィンドウを保持します。このプロパティは、任意のアイテムにアタッチすることができます。アイテムがApplicationWindow にない場合、値はnull
になります。
Attached ApplicationWindow Propertiesも参照して ください。
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。