XdgPopup QML Type
XdgPopup은 xdg 표면의 팝업 관련 부분을 나타냅니다. 더 보기...
| Import Statement: | import QtWayland.Compositor.XdgShell |
| In C++: | QWaylandXdgPopup |
속성
- anchorEdges : enumeration
- anchorRect : rect
- configuredGeometry : rect
- flipConstraints : enumeration
- gravityEdges : rect
- offset : point
- parentXdgSurface : XdgSurface
- positionerSize : size
- resizeConstraints : enumeration
- slideConstraints : enumeration
- unconstrainedPosition : point
- xdgSurface : XdgSurface
방법
- int sendConfigure(rect geometry)
- void sendPopupDone()
상세 설명
이 유형은 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]
popup이 configure 이벤트에서 수신한 창 지오메트리입니다. 부모 표면의 왼쪽 상단 모서리를 기준으로 합니다.
flipConstraints : enumeration [read-only]
이 속성은 자식 요소가 화면에 맞게 회전해야 하는 방향을 지정합니다.
사용 가능한 값:
| 상수 | 설명 |
|---|---|
Qt.Horizontal | 가로 |
Qt.Vertical | 수직 |
gravityEdges : rect [read-only]
앵커 포인트를 기준으로 표면을 어떤 방향으로 배치할지 지정합니다.
사용 가능한 값은 다음과 같습니다:
| 상수 | 설명 |
|---|---|
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]
이 속성은 자식 요소가 화면 내에 맞게 크기를 조정할 때 적용할 방향을 지정합니다.
사용 가능한 값:
| 상수 | 설명 |
|---|---|
Qt.Horizontal | 가로 |
Qt.Vertical | 수직 |
slideConstraints : enumeration [read-only]
이 속성은 자식 요소가 화면에 맞게 이동해야 하는 방향을 지정합니다.
사용 가능한 값:
| 상수 | 설명 |
|---|---|
Qt.Horizontal | 수평 |
Qt.Vertical | 수직 |
unconstrainedPosition : point [read-only]
표면에 제약 조건이 적용되지 않은 경우, 부모 창의 기하학적 구조에 대한 표면의 위치. 즉, 화면 내부에 맞도록 이동되지 않았을 때 등을 말한다.
xdgSurface : XdgSurface [read-only]
이 속성은 이 XdgPopup 와 연관된 XdgSurface 를 포함합니다.
메서드 문서
int sendConfigure(rect geometry)
클라이언트에 configure 이벤트를 전송합니다. ` geometry `에는 부모 서피스의 창 지오메트리 왼쪽 상단 모서리를 기준으로 한 창 지오메트리가 포함됩니다.
이는 암시적으로 해당 ` XdgSurface `에도 구성 이벤트를 전송합니다.
void sendPopupDone()
팝업을 닫습니다. xdg-shell 프로토콜에 따르면, 이렇게 하면 클라이언트가 팝업을 제거하게 됩니다.
© 2026 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.
