QWaylandWlShellSurface Class
QWaylandWlShellSurface 클래스는 표면에 데스크톱 스타일의 컴포지터 전용 기능을 제공합니다. 더 보기...
| 헤더: | #include <QWaylandWlShellSurface> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor) target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor) |
| qmake: | QT += waylandcompositor |
| QML에서: | WlShellSurface |
| 상속: | QWaylandShellSurfaceTemplate |
공개 유형
| enum | ResizeEdge { NoneEdge, TopEdge, BottomEdge, LeftEdge, TopLeftEdge, …, BottomRightEdge } |
속성
공개 함수
| QWaylandWlShellSurface() | |
| QWaylandWlShellSurface(QWaylandWlShell *shell, QWaylandSurface *surface, const QWaylandResource &res) | |
| QString | className() const |
| void | initialize(QWaylandWlShell *shell, QWaylandSurface *surface, const QWaylandResource &resource) |
| void | sendConfigure(const QSize &size, QWaylandWlShellSurface::ResizeEdge edges) |
| void | sendPopupDone() |
| QWaylandWlShell * | shell() const |
| QWaylandSurface * | surface() const |
| QString | title() const |
공개 슬롯
| void | ping() |
신호
| void | classNameChanged() |
| void | shellChanged() |
| void | surfaceChanged() |
| void | titleChanged() |
정적 공용 멤버
| QWaylandWlShellSurface * | fromResource(wl_resource *resource) |
상세 설명
이 클래스는 QWaylandWlShell 확장 기능의 일부이며, 표면 크기 조정 및 이동과 같은 데스크톱 스타일 컴포지터에 특화된 기능을 통해 기존 QWaylandSurface 의 기능을 확장할 수 있는 방법을 제공합니다.
이 클래스는 Wayland 인터페이스 wl_shell_surface 에 해당합니다.
멤버 유형 문서
enum QWaylandWlShellSurface::ResizeEdge
이 열거형 유형은 표면의 모서리나 모퉁이를 지정하는 방법을 제공합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QWaylandWlShellSurface::NoneEdge | 0 | 가장자리가 없습니다. |
QWaylandWlShellSurface::TopEdge | 1 | 가장자리가 없습니다. |
QWaylandWlShellSurface::BottomEdge | 2 | 하단 가장자리. |
QWaylandWlShellSurface::LeftEdge | 4 | 왼쪽 가장자리. |
QWaylandWlShellSurface::TopLeftEdge | 5 | 왼쪽 상단 모서리. |
QWaylandWlShellSurface::BottomLeftEdge | 6 | 왼쪽 아래 모서리. |
QWaylandWlShellSurface::RightEdge | 8 | 오른쪽 가장자리. |
QWaylandWlShellSurface::TopRightEdge | 9 | 오른쪽 상단 모서리. |
QWaylandWlShellSurface::BottomRightEdge | 10 | 오른쪽 아래 모서리. |
속성 문서
[read-only] className : QString
이 속성은 QWaylandWlShellSurface 의 클래스 이름을 저장합니다.
액세스 함수:
| QString | className() const |
Notifier 신호:
| void | classNameChanged() |
[read-only] shell : QWaylandWlShell*
이 속성은 이 QWaylandWlShellSurface 에 연결된 셸을 저장합니다.
액세스 함수:
| QWaylandWlShell * | shell() const |
알림 신호:
| void | shellChanged() |
[read-only] surface : QWaylandSurface*
이 속성은 이 QWaylandWlShellSurface 에 연결된 표면을 포함합니다.
액세스 함수:
| QWaylandSurface * | surface() const |
알림 신호:
| void | surfaceChanged() |
[read-only] title : QString
이 부동산은 ‘ QWaylandWlShellSurface ’라는 명칭을 가지고 있습니다.
액세스 기능:
| QString | title() const |
알림 신호:
| void | titleChanged() |
멤버 함수 설명서
QWaylandWlShellSurface::QWaylandWlShellSurface()
QWaylandWlShellSurface 객체를 생성합니다.
QWaylandWlShellSurface::QWaylandWlShellSurface(QWaylandWlShell *shell, QWaylandSurface *surface, const QWaylandResource &res)
surface 용 QWaylandWlShellSurface를 생성하고, 지정된 shell 및 리소스 res 로 이를 초기화합니다.
[static] QWaylandWlShellSurface *QWaylandWlShellSurface::fromResource(wl_resource *resource)
지정된 ` resource`와 연관된 ` QWaylandWlShellSurface ` 객체를 반환하거나, 해당 객체가 존재하지 않으면 `null`을 반환합니다.
[invokable] void QWaylandWlShellSurface::initialize(QWaylandWlShell *shell, QWaylandSurface *surface, const QWaylandResource &resource)
QWaylandWlShellSurface 를 초기화하고, 이를 지정된 shell, surface 및 resource 와 연결합니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
[slot] void QWaylandWlShellSurface::ping()
클라이언트에게 핑 이벤트를 전송합니다. 클라이언트가 이 이벤트에 응답하면 퐁 신호가 발신됩니다.
[invokable] void QWaylandWlShellSurface::sendConfigure(const QSize &size, QWaylandWlShellSurface::ResizeEdge edges)
클라이언트에 configure 이벤트를 전송하여, 제공된 ` size`에 따라 표면의 크기를 조정할 것을 제안합니다. ` edges `는 표면의 크기가 어떻게 조정되었는지에 대한 힌트를 제공합니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
[invokable] void QWaylandWlShellSurface::sendPopupDone()
사용자가 클라이언트의 표면 외부 어딘가를 클릭했음을 알리기 위해 클라이언트에 popup_done 이벤트를 전송합니다.
참고: 이 함수는 메타 객체 시스템 및 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
© 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.
