XdgPopup QML Type

XdgPopup은 팝업의 특정 부분과 xdg 표면을 나타냅니다. 더 보기...

Import Statement: import QtWayland.Compositor.XdgShell
In C++: QWaylandXdgPopup

속성

방법

상세 설명

이 유형은 XdgShell 확장의 일부이며 xdg 서페이스에 대한 데스크톱 스타일 메뉴 전용 기능으로 XdgSurface 의 기능을 확장하는 방법을 제공합니다.

이는 Wayland 인터페이스 xdg_popup 에 해당합니다.

속성 문서

anchorEdges : enumeration [read-only]

이 프로퍼티는 자식 서페이스가 상대적으로 배치되어야 하는 앵커 사각형의 에지 집합을 보유합니다. 방향에 에지가 지정되지 않은 경우, 앵커 포인트는 에지 사이의 중앙에 위치해야 합니다.

가능한 값은 다음과 같습니다:

상수설명
Qt.TopEdge직사각형의 위쪽 가장자리입니다.
Qt.LeftEdge직사각형의 왼쪽 가장자리입니다.
Qt.RightEdge직사각형의 오른쪽 가장자리입니다.
Qt.BottomEdge직사각형의 아래쪽 가장자리입니다.

anchorRect : rect [read-only]

자식 서페이스가 배치될 부모 창 지오메트리를 기준으로 한 앵커 사각형입니다.


configuredGeometry : rect [read-only]

구성 이벤트에서 팝업이 수신한 창 지오메트리입니다. 부모 서페이스의 왼쪽 상단 모서리를 기준으로 합니다.


flipConstraints : enumeration [read-only]

이 프로퍼티는 자식이 화면 내에 맞도록 뒤집어야 하는 방향을 유지합니다.

가능한 값은 다음과 같습니다:

Constant설명
Qt.HorizontalHorizontal
Qt.Vertical수직

gravityEdges : rect [read-only]

앵커 포인트를 기준으로 서페이스가 배치될 방향을 지정합니다.

가능한 값은 다음과 같습니다:

Constant설명
Qt.TopEdge서페이스가 화면 위쪽으로 미끄러집니다.
Qt.LeftEdge서페이스가 화면 왼쪽으로 미끄러져야 합니다.
Qt.RightEdge서페이스가 화면 오른쪽으로 미끄러져야 합니다.
Qt.BottomEdge서페이스가 화면 하단을 향해 미끄러져야 합니다.

offset : point [read-only]

앵커 직사각형의 앵커 위치와 서페이스의 앵커 위치를 기준으로 한 위치입니다.


parentXdgSurface : XdgSurface [read-only]

이 속성은 XdgPopup 의 부모와 연결된 XdgSurface 을 보유합니다.


positionerSize : size [read-only]

포지셔너 객체가 창 지오메트리에 요청한 크기입니다.


resizeConstraints : enumeration [read-only]

이 속성은 자식이 화면 내에 맞게 크기를 조정해야 하는 방향을 보유합니다.

가능한 값은 다음과 같습니다:

Constant설명
Qt.HorizontalHorizontal
Qt.Vertical수직

slideConstraints : enumeration [read-only]

이 속성은 자식이 화면 내에 맞게 슬라이드해야 하는 방향을 저장합니다.

가능한 값은 다음과 같습니다:

Constant설명
Qt.HorizontalHorizontal
Qt.Vertical수직

unconstrainedPosition : point [read-only]

서페이스가 제약되지 않은 경우 부모 창 지오메트리를 기준으로 한 서페이스의 위치입니다. 즉, 화면 내부에 맞추기 위해 이동하지 않은 경우 또는 이와 유사한 경우입니다.


xdgSurface : XdgSurface [read-only]

이 프로퍼티는 XdgPopup 과 연결된 XdgSurface 을 보유합니다.


메서드 문서

int sendConfigure(rect geometry)

geometry 에는 부모 서페이스의 창 지오메트리 왼쪽 상단 모서리를 기준으로 한 창 지오메트리가 포함됩니다.

그러면 해당 XdgSurface 에도 구성 이벤트가 암시적으로 전송됩니다.


void sendPopupDone()

팝업을 닫습니다. xdg-shell 프로토콜에 따라 클라이언트가 팝업을 소멸시켜야 합니다.


© 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.