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 です。


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.