Overlay QML Type

팝업을 위한 창 오버레이입니다. 더 보기...

Import Statement:	`import QtQuick.Controls`
Inherits:	Item

상속된 멤버를 포함한 모든 멤버 목록

첨부된 속성

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 를참조하세요 .

첨부 프로퍼티 문서

이 첨부 프로퍼티는 모달 팝업의 배경 어둡기를 구현하는 시각적 항목으로 사용할 컴포넌트를 보유합니다. 보이는 모달 팝업에 대해 생성되어 그 아래에 쌓입니다.

이 프로퍼티는 모든 팝업에 첨부할 수 있습니다.

예를 들어 모달 팝업의 배경 디밍 색상을 변경하려면 다음 코드를 사용할 수 있습니다:

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.