XdgShell QML Type
데스크톱 스타일 사용자 인터페이스를 위한 확장 기능을 제공합니다. 더 보기...
| Import Statement: | import QtWayland.Compositor.XdgShell |
| In C++: | QWaylandXdgShell |
신호
- pong(int serial)
- popupCreated(XdgPopup popup, XdgSurface xdgSurface)
- toplevelCreated(XdgToplevel toplevel, XdgSurface xdgSurface)
- xdgSurfaceCreated(XdgSurface xdgSurface)
방법
- void ping(WaylandClient client)
상세 설명
XdgShell 확장 기능은 XdgToplevel 또는 XdgPopup 를 일반 Wayland 표면과 연결하는 방법을 제공합니다. 클라이언트는 XdgToplevel 인터페이스를 사용하여 표면의 크기 조정, 이동 등을 요청할 수 있습니다.
XdgShell은 Wayland 인터페이스인 xdg_shell 에 해당합니다.
컴포지터에서 셸 확장 기능의 기능을 제공하려면, XdgShell 컴포넌트의 인스턴스를 생성하고 이를 컴포지터가 지원하는 확장 목록에 추가하십시오:
import QtWayland.Compositor.XdgShell
WaylandCompositor {
XdgShell {
// ...
}
}Signal 문서
pong(int serial)
이 신호는 클라이언트가 ping 이벤트에 대해 시리얼 값 serial 으로 응답했을 때 발생합니다.
참고: 이에 대응하는핸들러는 onPong 입니다.
ping()도 참조하십시오 .
popupCreated(XdgPopup popup, XdgSurface xdgSurface)
이 신호는 클라이언트가 ` xdg_popup`를 생성했을 때 발생합니다. 일반적인 사용 사례로는, 이 신호의 핸들러가 ` QtQuick ` 씬에서 ` popup `을 표시하기 위해 ` ShellSurfaceItem ` 또는 ` WaylandQuickItem `을 인스턴스화하도록 하는 것입니다.
xdgSurface XdgSurface 는 의 역할 객체입니다. popup
참고: 해당 핸들러는 onPopupCreated 입니다.
toplevelCreated(XdgToplevel toplevel, XdgSurface xdgSurface)
이 신호는 클라이언트가 ` xdg_toplevel`를 생성했을 때 발생합니다. 일반적인 사용 사례로는, 이 신호의 핸들러가 ` QtQuick ` 씬에서 ` toplevel `를 표시하기 위해 ` ShellSurfaceItem ` 또는 ` WaylandQuickItem `를 인스턴스화하도록 하는 것입니다.
xdgSurface XdgSurface 는 의 역할 객체입니다. toplevel
참고: 해당 핸들러는 onToplevelCreated 입니다.
xdgSurfaceCreated(XdgSurface xdgSurface)
이 신호는 클라이언트가 xdg_surface 를 생성했을 때 발생합니다. xdgSurface 는 매핑되지 않았으므로, 즉 xdg-shell 프로토콜에 따라 역할 객체를 수신하기 전까지는 표시되어서는 안 된다는 점에 유의하십시오.
참고: 해당 핸들러는 onXdgSurfaceCreated 입니다.
toplevelCreated() 및 popupCreated()도 참조하십시오 .
메서드 문서
void ping(WaylandClient client)
client 에 ping 이벤트를 전송합니다. 클라이언트가 해당 이벤트에 응답하면 pong 신호가 발생합니다.
© 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.