ApplicationWindow QML Type

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

• 継承されたメンバーを含む全メンバーのリスト

プロパティ

• activeFocusControl : Control
• background : Item
• bottomPadding : real (since 6.9)
• contentData : list<QtObject>
• contentItem : Item
• font : font
• footer : Item
• header : Item
• leftPadding : real (since 6.9)
• locale : Locale
• menuBar : Item (since QtQuick.Controls 2.3 (Qt 5.10))
• rightPadding : real (since 6.9)
• topPadding : real (since 6.9)

付属物件

• 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

ApplicationWindow {
    visible: true

    menuBar: MenuBar {
        // ...
    }

    header: ToolBar {
        // ...
    }

    footer: TabBar {
        // ...
    }

    StackView {
        anchors.fill: parent
    }
}

ApplicationWindowのプロパティ

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

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

安全な領域

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

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

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

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

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

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

プロパティ文書

activeFocusControl : Control [read-only]

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

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

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

background : Item

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

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

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

ApplicationWindow のカスタマイズ、contentItem 、header 、footerも参照してください 。

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 アイテムの上にスタックされ、menuBar 、header 、footer アイテムの下にスタックされます。

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も参照してください 。

footer : Item

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

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

menuBar 、header 、Page::footerも参照してください 。

header : Item

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

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

menuBar,footer,Page::headerも参照してください 。

leftPadding : real [since 6.9]

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

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

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

locale : Locale

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

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

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

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

menuBar : Item [since QtQuick.Controls 2.3 (Qt 5.10)]

このプロパティはウィンドウメニューバーを保持する。メニューバーはウィンドウの上部、ヘッダーの上に配置され、ウィンドウの幅に合わせてリサイズされる。デフォルト値は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 Property ドキュメント

ApplicationWindow.activeFocusControl : Control [read-only]

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

Window::activeFocusItem およびAttached ApplicationWindow Propertiesも参照のこと 。

ApplicationWindow.contentItem : Item [read-only]

この付属プロパティは、ウィンドウコンテンツ項目を保持する。このプロパティは任意のアイテムにアタッチすることができる。アイテムがApplicationWindow にない場合、値はnull となる。

Attached ApplicationWindow Propertiesも参照のこと 。

ApplicationWindow.footer : Item [read-only]

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

Attached ApplicationWindow Propertiesも参照のこと 。

ApplicationWindow.header : Item [read-only]

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

Attached ApplicationWindow Propertiesも参照のこと 。

ApplicationWindow.menuBar : Item [read-only, since QtQuick.Controls 2.3 (Qt 5.10)]

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

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

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

ApplicationWindow.window : ApplicationWindow [read-only]

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

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