이 페이지에서

WlShell QML Type

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

Import Statement: import QtWayland.Compositor.WlShell
In C++: QWaylandWlShell

신호

상세 설명

WlShell 확장 기능은 ShellSurface 를 일반 Wayland 표면과 연결하는 방법을 제공합니다. 클라이언트는 셸 표면 인터페이스를 사용하여 표면의 크기 조정, 이동 등을 요청할 수 있습니다.

WlShell은 Wayland 인터페이스 wl_shell 에 해당합니다.

컴포지터에서 셸 확장 기능의 기능을 제공하려면 WlShell 컴포넌트의 인스턴스를 생성하고 이를 컴포지터가 지원하는 확장 목록에 추가하십시오:

import QtWayland.Compositor.WlShell

WaylandCompositor {
    WlShell {
        // ...
    }
}

Signal 문서

void wlShellSurfaceCreated(WlShellSurface shellSurface)

이 신호는 클라이언트가 ` wl_shell_surface`를 생성했을 때 발생합니다. 일반적인 사용 사례로는, 이 신호의 핸들러가 ` QtQuick ` 씬에서 ` shellSurface `를 표시하기 위해 ` ShellSurfaceItem ` 또는 ` WaylandQuickItem `를 인스턴스화하도록 하는 것입니다.

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

void wlShellSurfaceRequested(WaylandSurface surface, WaylandResource resource)

이 신호는 클라이언트가 wl_shell_surface 를 surface 에 연결하도록 요청했을 때 발생합니다. 이 신호의 핸들러는 resource 에 대한 셸 서피스를 생성하고, 신호 발생 범위 내에서 이를 초기화할 수 있습니다. 그렇지 않은 경우 WlShellSurface 가 자동으로 생성됩니다.

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

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