Back to Qt.io
Contact Us Blog Download Qt
이 페이지에서

QWaylandXdgSurface Class

QWaylandXdgSurface 클래스는 xdg 표면에 데스크톱 스타일의 컴포지터 전용 기능을 제공합니다. 더 보기...

헤더: #include <QWaylandXdgSurface>
CMake: find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor)
target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor)
qmake: QT += waylandcompositor
QML에서: XdgSurface
상속: QWaylandShellSurfaceTemplate

속성

공개 함수

QWaylandXdgSurface()
QWaylandXdgSurface(QWaylandXdgShell *xdgShell, QWaylandSurface *surface, const QWaylandResource &res)
void initialize(QWaylandXdgShell *xdgShell, QWaylandSurface *surface, const QWaylandResource &resource)
QWaylandXdgPopup *popup() const
QWaylandXdgShell *shell() const
QWaylandSurface *surface() const
QWaylandXdgToplevel *toplevel() const
QRect windowGeometry() const

신호

void popupCreated()
void shellChanged()
void surfaceChanged()
void toplevelCreated()
void windowGeometryChanged()

정적 공용 멤버

QWaylandXdgSurface *fromResource(wl_resource *resource)
const struct wl_interface *interface()

상세 설명

이 클래스는 QWaylandXdgShell 확장 기능의 일부이며, 표면의 크기 조정 및 이동과 같은 데스크톱 스타일 컴포지터에 특화된 기능을 통해 기존 QWaylandSurface 의 기능을 확장할 수 있는 방법을 제공합니다.

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

속성 문서

이 속성은 팝업 QWaylandXdgSurface 에 고유한 속성과 메서드를 포함합니다.

액세스 함수:

QWaylandXdgPopup *popup() const

Notifier 시그널:

void popupCreated()

관련 항목: QWaylandXdgSurface::toplevel 및 QWaylandXdgShell::popupCreated.

[read-only] shell : QWaylandXdgShell*

이 속성은 이 QWaylandXdgSurface 에 연결된 셸을 저장합니다.

액세스 함수:

QWaylandXdgShell *shell() const

알림 신호:

void shellChanged()

[read-only] surface : QWaylandSurface*

이 속성은 이 QWaylandXdgSurface 에 연결된 표면을 포함합니다.

액세스 함수:

QWaylandSurface *surface() const

알림 신호:

void surfaceChanged()

[read-only] toplevel : QWaylandXdgToplevel*

이 속성은 최상위 ` QWaylandXdgSurface`에 특정한 속성과 메서드를 포함합니다.

액세스 함수:

QWaylandXdgToplevel *toplevel() const

Notifier 신호:

void toplevelCreated()

QWaylandXdgSurface::popup 및 QWaylandXdgShell::toplevelCreated도 참조하십시오 .

[read-only] windowGeometry : QRect

이 속성은 ` QWaylandXdgSurface`의 창 지오메트리를 저장합니다. 창 지오메트리는 사용자의 관점에서 볼 때 창의 가시 영역을 나타냅니다. 이 지오메트리에는 클라이언트가 그린 제목 표시줄과 테두리가 포함되지만, 그림자는 제외됩니다. 이 속성은 창을 정렬하거나 나란히 배치하는 데 사용됩니다.

액세스 함수:

QRect windowGeometry() const

알림 신호:

void windowGeometryChanged()

멤버 함수 문서

[explicit] QWaylandXdgSurface::QWaylandXdgSurface()

QWaylandXdgSurface 객체를 생성합니다.

[explicit] QWaylandXdgSurface::QWaylandXdgSurface(QWaylandXdgShell *xdgShell, QWaylandSurface *surface, const QWaylandResource &res)

surface 용 QWaylandXdgSurface를 생성하고, 지정된 xdgShell, surface 및 리소스 res 로 초기화합니다.

[static] QWaylandXdgSurface *QWaylandXdgSurface::fromResource(wl_resource *resource)

resource 에 해당하는 QWaylandXdgSurface 를 반환합니다.

[invokable] void QWaylandXdgSurface::initialize(QWaylandXdgShell *xdgShell, QWaylandSurface *surface, const QWaylandResource &resource)

QWaylandXdgSurface 를 초기화하고, 이를 주어진 xdgShell, surface 및 resource 과 연결합니다.

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.

[static] const struct wl_interface *QWaylandXdgSurface::interface()

QWaylandXdgSurface 에 대한 Wayland 인터페이스를 반환합니다.

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