Back to Qt.io
Contact Us Blog Download Qt

XdgShell QML Type

데스크톱 스타일의 사용자 인터페이스를 위한 확장 기능을 제공합니다. 자세히...

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

신호

방법

  • void ping(WaylandClient client)

자세한 설명

XdgShell 확장은 XdgToplevel 또는 XdgPopup 을 일반 Wayland 서페이스와 연결하는 방법을 제공합니다. 클라이언트는 XdgToplevel 인터페이스를 사용하여 서페이스의 크기 조정, 이동 등을 요청할 수 있습니다.

XdgShell은 Wayland 인터페이스인 xdg_shell 에 해당합니다.

컴포저에서 셸 확장 기능을 제공하려면 XdgShell 컴포넌트의 인스턴스를 생성하고 컴포저에서 지원하는 확장 목록에 추가합니다:

import QtWayland.Compositor.XdgShell

WaylandCompositor {
    XdgShell {
        // ...
    }
}

신호 문서

pong(int serial)

이 신호는 클라이언트가 시리얼( serial)로 핑 이벤트에 응답했을 때 발생합니다.

참고: 해당 핸들러는 onPong 입니다.

ping()도 참조하세요 .


popupCreated(XdgPopup popup, XdgSurface xdgSurface)

이 신호는 클라이언트가 xdg_popup 를 생성했을 때 발생합니다. 일반적인 사용 사례는 이 신호의 핸들러가 ShellSurfaceItem 또는 WaylandQuickItem 를 인스턴스화하여 QtQuick 장면에 popup 을 표시하는 것입니다.

xdgSurface 는 XdgSurface popup 의 역할 객체입니다.

참고: 해당 핸들러는 onPopupCreated 입니다.


toplevelCreated(XdgToplevel toplevel, XdgSurface xdgSurface)

이 신호는 클라이언트가 xdg_toplevel 를 생성했을 때 발생합니다. 일반적인 사용 사례는 이 신호의 핸들러가 ShellSurfaceItem 또는 WaylandQuickItem 를 인스턴스화하여 QtQuick 장면에 toplevel 을 표시하도록 하는 것입니다.

xdgSurface 는 XdgSurface toplevel 의 역할 객체입니다.

참고: 해당 핸들러는 onToplevelCreated 입니다.


xdgSurfaceCreated(XdgSurface xdgSurface)

이 신호는 클라이언트가 xdg_surface 을 만들었을 때 발생합니다. xdgSurface 은 매핑되지 않았으므로 xdg-shell 프로토콜에 따라 역할 객체를 수신할 때까지 표시되지 않아야 합니다.

참고: 해당 핸들러는 onXdgSurfaceCreated 입니다.

toplevelCreated() 및 popupCreated()도 참조하세요 .


메서드 문서

void ping(WaylandClient client)

client 으로 핑 이벤트를 전송합니다. 클라이언트가 이벤트에 응답하면 pong 신호가 전송됩니다.


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