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 신호 문서

[attached] pressed()

이 첨부된 신호는 팝업이 표시된 상태에서 사용자가 오버레이를 누를 때 발생합니다.

이 신호는 모든 항목, 팝업 또는 창에 연결할 수 있습니다. 항목이나 팝업에 연결된 경우, 해당 항목이나 팝업이 창 내에 있을 때만 신호가 발생합니다.

[attached] released()

이 첨부된 신호는 팝업이 표시된 상태에서 사용자가 오버레이를 해제할 때 발생합니다.

이 신호는 모든 항목, 팝업 또는 창에 연결할 수 있습니다. 항목이나 팝업에 연결된 경우, 해당 항목이나 팝업이 창 내에 있을 때만 신호가 발생합니다.