Back to Qt.io
Contact Us Blog Download Qt

Overlay QML Type

ポップアップ用のウィンドウ・オーバーレイ。もっと見る...

Import Statement: import QtQuick.Controls
Inherits:

Item

付属プロパティ

付属シグナル

詳細説明

オーバーレイはポップアップのためのレイヤーを提供し、ポップアップが他のコンテンツの上に表示され、modal またはdimmed ポップアップが表示されているときに背景が暗くなるようにします。

オーバーレイはウィンドウ全体を覆う普通のアイテムです。シーン座標でポップアップを配置するための視覚的な親として使用できます。

次の例では、添付のOverlay.overlay プロパティを使用して、ポップアップを開くボタンの位置にもかかわらず、ポップアップをウィンドウの中央に配置しています：

Button {
    onClicked: popup.open()

    Popup {
        id: popup

        parent: Overlay.overlay

        x: Math.round((parent.width - width) / 2)
        y: Math.round((parent.height - height) / 2)
        width: 100
        height: 100
    }
}

ApplicationWindowも参照して ください。

Attached プロパティのドキュメント

この Attached プロパティは、モーダルポップアップの背景調光を実装するビジュアルアイテムとして使用するコンポーネントを保持します。このプロパティは、可視モーダルポップアップのために作成され、可視モーダルポップアップの下にスタックされます。

このプロパティはどのポップアップにもアタッチできます。

例えば、モーダルポップアップの背景調光の色を変更するには、以下のコードを使用します：

Popup {
    id: popup
    width: 400
    height: 400
    modal: true
    visible: true

    Overlay.modal: Rectangle {
        color: "#aacfdbe7"
    }
}

Popup::modalも参照して ください。


Overlay.modeless : Component

このアタッチされたプロパティは、モードレスポップアップの背景調光を実装するビジュアルアイテムとして使用するコンポーネントを保持します。このプロパティは可視調光ポップアップのために作成され、可視調光ポップアップの下にスタックされます。

このプロパティはどのポップアップにもアタッチできます。

例えば、モデルレスポップアップの背景調光の色を変更するには、以下のコードを使用します：

Popup {
    id: popup
    width: 400
    height: 400
    dim: true
    visible: true

    Overlay.modeless: Rectangle {
        color: "#aacfdbe7"
    }
}

Popup::dimも参照してください 。


Overlay.overlay : Overlay [read-only]

このアタッチされたプロパティは、ウィンドウ・オーバーレイ項目を保持します。

このプロパティは、任意のアイテム、ポップアップ、またはウィンドウにアタッチすることができます。アイテムまたはポップアップにアタッチされた場合、アイテムまたはポップアップがウィンドウ内にない場合、値はnull になります。


アタッチドシグナルのドキュメント

pressed()

このアタッチドシグナルは、ポップアップが表示されているときに、ユーザによってオーバーレイが押されたときに発信されます。

このシグナルは任意のアイテム、ポップアップ、ウィンドウにアタッチすることができます。アイテムやポップアップにアタッチされた場合、シグナルはアイテムやポップアップがウィンドウ内にある場合にのみ発行されます。

注意: 対応するハンドラはonPressed です。


released()

このアタッチされたシグナルは、ポップアップが表示されているときに、オーバーレイがユーザーによってリリースされたときに発行されます。

このシグナルは任意のアイテム、ポップアップ、ウィンドウにアタッチできます。アイテムやポップアップにアタッチされた場合、シグナルはアイテムやポップアップがウィンドウ内にある場合にのみ発行されます。

注意: 対応するハンドラはonReleased です。


©2024 The Qt Company Ltd. 本文書に含まれる文書の著作権は、それぞれの所有者に帰属します。 ここで提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。