Window QML Type

ウィンドウの位置とサイズを定義します。

(x,y)位置は、Screen （1つしかない場合）、または仮想デスクトップ（複数のスクリーンの配置）に対する相対位置です。

Window { x: 100; y: 100; width: 100; height: 100 }

ウィンドウの最小サイズを定義します。

これは指定された幅と高さ以下のリサイズを防ぐためのウィンドウマネージャへのヒントです。

ウィンドウの最大サイズを定義します。

これは指定された幅と高さ以上のリサイズを防ぐためのウィンドウマネージャへのヒントです。

ウィンドウのアクティブ状態。

Window {
    visible: true

    // here we use the Window.active and Window.palette ordinary properties
    color: active ? palette.active.window : palette.inactive.window
}

requestActivate()も参照 。

現在アクティブなフォーカスを持つ項目、またはアクティブなフォーカスを持つ項目がない場合はnull を指定します。

ウィンドウの背景色。

このプロパティを設定すると、別のRectangleを使用するよりも効率的です。

シーンの不可視ルートアイテム。

これはウィンドウマネージャがウィンドウに関連してポップアップ、ダイアログ、ステータスバーなどの追加コンテンツを表示する必要がある場合のヒントです。

推奨される向きはScreen.orientation ですが、アプリケーションはすべての可能な向きをサポートする必要はないので、現在の画面の向きを無視することもできます。

ウィンドウとコンテンツの向きの差は、コンテンツをどれだけ回転させるかを決定します。

デフォルト値はQt::PrimaryOrientation です。

Screenも参照してください 。

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

データリストに別のウィンドウを割り当てると、入れ子になったウィンドウは外側のウィンドウの「一時的な」ウィンドウになります。

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

他のオブジェクトタイプを割り当てると、リソースとして追加されます。

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

QWindow::transientParent()も参照してください 。

ウィンドウのウィンドウフラグ。

ウィンドウフラグは、ウィンドウシステムにおけるウィンドウの外観、ダイアログかポップアップか通常のウィンドウか、タイトルバーの有無などを制御します。

このプロパティから読み取るフラグは、要求されたフラグを満たすことができなかった場合、設定したフラグと異なる場合があります。

import QtQuick

Window {
    id: mainWindow
    title: "Main Window"
    color: "#456"
    property real defaultSpacing: 10

    property Splash splash: Splash {
        onTimeout: mainWindow.show()
    }

    component Splash: Window {
        id: splash

        // a splash screen has no titlebar
        flags: Qt.SplashScreen
        // the transparent color lets background behind the image edges show through
        color: "transparent"
        modality: Qt.ApplicationModal // in case another application window is showing
        title: "Splash Window" // for the taskbar/dock, task switcher etc.
        visible: true

        // here we use the Screen attached property to center the splash window
        x: (Screen.width - splashImage.width) / 2
        y: (Screen.height - splashImage.height) / 2
        width: splashImage.width
        height: splashImage.height

        property int timeoutInterval: 2000
        signal timeout

        Image {
            id: splashImage
            source: "images/qt-logo.png"
        }

        TapHandler {
            onTapped: splash.timeout()
        }

        Timer {
            interval: splash.timeoutInterval; running: true; repeat: false
            onTriggered: {
                splash.visible = false
                splash.timeout()
            }
        }
    }
}

Qt::WindowFlags およびQt Quick Examples - Window and Screenも参照して ください。

ウィンドウのモダリティ。

モーダルウィンドウは、他のウィンドウが入力イベントを受け取るのを防ぎます。指定できる値は Qt.NonModal（デフォルト）、Qt.WindowModal、Qt.ApplicationModal です。

ウィンドウの不透明度。

ウィンドウシステムがウィンドウの不透明度をサポートしている場合、これを使用してウィンドウをフェードイン/フェードアウトしたり、半透明にしたりすることができます。

1.0以上の値は完全な不透明として扱われ、0.0以下の値は完全な透明として扱われます。その中間の値は、両極端の間のさまざまな半透明のレベルを表します。

デフォルト値は1.0である。

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

デフォルトのパレットはシステム環境に依存します。QGuiApplication は、すべてのアプリケーション・ウィンドウのデフォルトとして機能するシステム/テーマ・パレットを保持します。QML を読み込む前にQGuiApplication::setPalette() にカスタムパレットを渡すことで、 ウィンドウのデフォルトパレットを設定することもできます。

Window は明示的なパレットプロパティを子アイテムやコントロールに伝達し、そのプロパティのシステムデフォルトを上書きします。

import QtQuick
import QtQuick.Controls

Window {
    visible: true

    // here we use the Window.active and Window.palette ordinary properties
    color: active ? palette.active.window : palette.inactive.window

    // colors that are not customized here come from SystemPalette
    palette.active.window: "peachpuff"
    palette.windowText: "brown"

    Text {
        anchors.centerIn: parent
        // here we use the Window.active attached property and the Item.palette property
        color: Window.active ? palette.active.windowText : palette.inactive.windowText
        text: Window.active ? "active" : "inactive"
    }

    Button {
        text: "Button"
        anchors {
            bottom: parent.bottom
            bottomMargin: 6
            horizontalCenter: parent.horizontalCenter
        }
    }
}

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

Item::palette,Popup::palette,ColorGroup,SystemPaletteも参照してください 。

ウィンドウが関連付けられているスクリーン。

ウィンドウを表示する前に指定すると、明示的なウィンドウ位置が設定されていない限り、ウィンドウはそのスクリーンに表示される。値はQt.application.screens配列の要素でなければなりません。

QWindow::setScreen()、QWindow::screen()、QScreen 、Qt.applicationも参照のこと 。

ウィンドウシステムにおけるウィンドウのタイトル。

ウィンドウのタイトルはウィンドウシステムとウィンドウフラグによって、 ウィンドウ装飾のタイトル領域に表示される。また、タスクスイッチャーなどの他のコンテキストでウィンドウを識別するためにウィンドウシステムによって使用されるかもしれません。

このウィンドウが一時的なポップアップであるウィンドウ。

これはウィンドウマネージャに対して、このウィンドウが一時的な親のためのダイアログまたはポップアップであることを示すヒントです。これは通常、トランジェントウィンドウが最初に表示されたときに、そのトランジェントペアレントウィンドウの中央に表示されること、ペアレントウィンドウを最小化するとトランジェントウィンドウも最小化されることなどを意味します。

アイテムまたは別の Window の内部で Window を宣言すると、default property または専用のプロパティによって、transientParent プロパティが明示的に設定されていない限り、含む Window に一時的な親子関係が自動的に設定されます。これは、parent 引数として Item または Window が渡される限り、Qt.createComponent またはQt.createQmlObject を介して Window アイテムを作成するときにも適用されます。

transient親を持つWindowは、visible プロパティがtrue であっても、そのtransient親が表示されるまで表示されません。これは前述の自動的な一時的親関係にも適用されます。特に、Windowの包含エレメントがItemの場合、そのビジュアル親階層を介して、包含アイテムがシーンに追加されるまで、Windowは表示されません。transientParentをnull に設定すると、この動作がオーバーライドされます：

Window {
    // visible is false by default
    Window {
        transientParent: null
        visible: true
    }
}

ウィンドウがデフォルトでその一時的な親の上にセンタリングされるようにするには、ウィンドウ マネージャによっては、Window::flags プロパティを適切なQt::WindowType （Qt::Dialog など）で設定する必要があります。

parent()も参照してください 。

ウィンドウの画面占有状態。

visibilityは、ウィンドウがウィンドウシステムで通常、最小化、最大化、フルスクリーン、非表示のどれで表示されるべきかを示す。

visibilityをAutomaticVisibility に設定することは、ウィンドウにデフォルトの可視状態を与えることを意味し、プラットフォームによってはFullScreen またはWindowed 。しかし、visibilityプロパティを読み取るときは、常に実際の状態を取得し、決してAutomaticVisibility 。

ウィンドウが表示されていないとき、その可視性はHidden であり、可視性をHidden に設定することは、visible をfalse に設定することと同じです。

import QtQuick
import QtQuick.Controls

Window {
    id: win
    flags: Qt.Window | Qt.WindowFullscreenButtonHint
    visibility: fullscreenButton.checked ? Window.FullScreen : Window.Windowed

    Button {
        id: fullscreenButton
        anchors {
            right: parent.right
            top: parent.top
            margins: 6
        }
        width: height
        checkable: true
        Binding on checked { value: win.visibility === Window.FullScreen }
        text: "⛶"
        ToolTip.visible: hovered
        ToolTip.delay: Qt.styleHints.mousePressAndHoldInterval
        ToolTip.text: win.visibility === Window.FullScreen ? qsTr("restore") : qsTr("fill screen")
    }
}

visible およびQt Quick Examples - Window and Screenも参照してください 。

ウィンドウが画面上に表示されているかどうか。

visible を false に設定することは、visibility からHidden に設定することと同じです。

デフォルト値はvisibility で上書きされない限りfalse です。

visibilityも参照してください 。

これらの付属プロパティは、アイテムのウィンドウのサイズを保持する。Window 添付プロパティは、どのアイテムにも添付することができます。

この付属プロパティはウィンドウがアクティブかどうかを示す。Window アタッチドプロパティは、どのアイテムにもアタッチできます。

以下は、ラベルが表示されているウィンドウのアクティブ状態を表示するようにラベルを変更する例です：

import QtQuick

Text {
    text: Window.active ? "active" : "inactive"
}

このアタッチされたプロパティは、現在アクティブなフォーカスを持つアイテムを保持し、アクティブなフォーカスを持つアイテムがない場合は、null 。Window attachedプロパティは、どのItemにもアタッチできる。

このアタッチドプロパティは、シーンの不可視ルートアイテムを保持し、アイテムがウィンドウ内にない場合は、null 。Window attachedプロパティは、任意のItemにアタッチすることができる。

このアタッチされたプロパティは、ウィンドウが現在ウィンドウシステムで通常、最小化、最大化、フルスクリーン、または非表示として表示されているかどうかを保持する。Window 添付プロパティは、任意のItemに添付することができる。アイテムがどのウィンドウにも表示されていない場合、値はHidden になります。

visible およびvisibilityも参照して ください。

このアタッチされたプロパティは、アイテムのウィンドウを保持する。Window attached プロパティは任意の Item にアタッチできる。

このシグナルは、レンダースレッドにシーングラフの同期を要求する前に、GUIスレッドに発行されます。

onAfterAnimatingを実装することで、各アニメーションステップの後に追加処理を行うことができます。

このシグナルは、ユーザーがウィンドウを閉じようとすると発行されます。

このシグナルにはclose パラメータが含まれます。close.accepted プロパティはデフォルトで true なので、ウィンドウを閉じることができます。しかし、ウィンドウを閉じる前に他の処理を行う必要がある場合は、onClosing ハンドラを実装して、close.accepted = false を設定することができます。

このシグナルは、フレームが提示のためにキューに入れられたときに発行されます。垂直同期が有効な場合、このシグナルは、連続的にアニメーションするシーンで、vsync 間隔ごとに最大 1 回発行されます。

このシグナルは、シーングラフの初期化中にerror が発生したときに発行されます。

onSceneGraphError(error、message) を実装して、グラフィックコンテキストの作成失敗などのエラーをカスタムで処理することができます。このシグナルにハンドラが接続されていない場合、Quick はmessage を表示するか、メッセージボックスを表示し、アプリケーションを終了します。

アラートをmsec ミリ秒間表示します。msec が0 (デフォルト) の場合、アラートはウィンドウが再びアクティブになるまで無期限に表示される。

アラート状態では、ウィンドウは、タスクバーのエントリを点滅させたり、バウンスさせるなどして、注意が必要であることを示す。

ウィンドウを閉じる。

このメソッドが呼び出されたとき、またはユーザーがタイトル バー ボタンでウィンドウを閉じようとしたとき、closing シグナルが発行されます。ハンドラがない場合、またはハンドラが閉じる許可を取り消さない場合、ウィンドウはその後閉じます。QGuiApplication::quitOnLastWindowClosed プロパティがtrue で、他に開いているウィンドウがない場合、アプリケーションは終了します。

ウィンドウを隠す。

visible をfalse に、またはvisibility をHidden に設定するのと同じです。

show()も参照してください 。

ウィンドウ・システムのウィンドウを下げる。

ウィンドウを下げて他のウィンドウの下に表示するように要求します。

ウィンドウシステムのウィンドウを上げます。

他のウィンドウの上に表示されるようにウィンドウを上げることを要求します。

ウィンドウをアクティブにする、すなわちキーボードフォーカスを受け取るように要求する。

ウィンドウを表示する。

これはshowFullScreen()、showMaximized()、showNormal() を呼び出すのと同じである。

showFullScreen()、showMaximized()、showNormal()、hide()、QQuickItem::flags()も参照 。

ウィンドウをフルスクリーンで表示する。

visibility をFullScreen に設定するのと同じです。

ウィンドウを最大化して表示します。

visibility をMaximized に設定するのと同じです。

ウィンドウを最小化して表示します。

visibility をMinimized に設定するのと同じです。

ウィンドウを通常の状態、つまり最大化も最小化もフルスクリーンもしない状態で表示します。

visibility をWindowed に設定するのと同じです。