Overlay QML Type

ポップアップ用のウィンドウオーバーレイ。詳細...

• 継承されたメンバーを含む、すべてのメンバーの一覧

関連プロパティ

• modal : Component
• modeless : Component
• overlay : Overlay

添付の信号

• pressed()
• released()

詳細説明

オーバーレイはポップアップ用のレイヤーを提供し、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」も参照してください 。

アタッチドプロパティのドキュメント

Overlay.modal : Component [attached]

この添付プロパティには、モーダルポップアップの背景を暗くする機能を実装した、ビジュアルアイテムとして使用するコンポーネントが含まれています。これは、表示中のモーダルポップアップ用に作成され、その下に重ねて表示されます。

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

たとえば、モーダルポップアップの背景の暗転の色を変更するには、次のコードを使用できます:

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

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

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

Overlay.modeless : Component [attached]

この添付プロパティには、モーダルではないポップアップの背景を暗くする機能を実装した、ビジュアルアイテムとして使用するコンポーネントが含まれています。これは、表示中の暗転ポップアップ用に作成され、その下に重ねて配置されます。

このプロパティは、どのポップアップにも添付できます。

たとえば、モーダルではないポップアップの背景暗転の色を変更するには、次のコードを使用できます:

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

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

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

Overlay.overlay : Overlay [read-only attached]

この添付プロパティには、ウィンドウオーバーレイ項目が格納されます。

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

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

[attached] pressed()

このシグナルは、ポップアップが表示されている間にユーザーがオーバーレイをタップした際に発火します。

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

[attached] released()

この添付シグナルは、ポップアップが表示されている状態で、ユーザーがオーバーレイを解除したときに発火します。

このシグナルは、任意のアイテム、ポップアップ、またはウィンドウに接続できます。アイテムやポップアップに接続した場合、そのアイテムやポップアップがウィンドウ内にある場合にのみ、シグナルが発火します。