このページでは

QWaylandXdgShell Class

QWaylandXdgShell クラスは、デスクトップスタイルのユーザーインターフェース向けの拡張機能です。詳細...

ヘッダー: #include <QWaylandXdgShell>
CMake: find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor)
target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor)
qmake: QT += waylandcompositor
QML内: XdgShell
継承元: QWaylandShellTemplate

パブリック関数

QWaylandXdgShell()
QWaylandXdgShell(QWaylandCompositor *compositor)

再実装されたパブリック関数

virtual void initialize() override

パブリックスロット

uint ping(QWaylandClient *client)

シグナル

void pong(uint serial)
void popupCreated(QWaylandXdgPopup *popup, QWaylandXdgSurface *xdgSurface)
void toplevelCreated(QWaylandXdgToplevel *toplevel, QWaylandXdgSurface *xdgSurface)
void xdgSurfaceCreated(QWaylandXdgSurface *xdgSurface)

静的パブリックメンバー

const struct wl_interface *interface()

詳細な説明

QWaylandXdgShell 拡張機能は、QWaylandXdgToplevel またはQWaylandXdgPopup を通常の Wayland サーフェスに関連付ける方法を提供します。QWaylandXdgToplevel インターフェースを使用することで、クライアントはサーフェスのサイズ変更や移動などを要求できます。

QWaylandXdgShellは、Waylandインターフェースであるxdg_shell に対応しています。

メンバ関数のドキュメント

[explicit] QWaylandXdgShell::QWaylandXdgShell()

QWaylandXdgShell オブジェクトを生成します。

[explicit] QWaylandXdgShell::QWaylandXdgShell(QWaylandCompositor *compositor)

指定されたcompositor に対して、QWaylandXdgShellオブジェクトを生成します。

[override virtual] void QWaylandXdgShell::initialize()

QWaylandCompositorExtension::initialize() を再実装します。

シェル拡張機能を初期化します。

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

QWaylandXdgShell の Wayland インターフェースを返します。

[slot] uint QWaylandXdgShell::ping(QWaylandClient *client)

client に対して ping イベントを送信します。クライアントがこのイベントに応答すると、pong シグナルが発火します。

[signal] void QWaylandXdgShell::pong(uint serial)

このシグナルは、クライアントがpingイベントに対してシリアルデータで応答した際(serial )に発生します。

QWaylandXdgShell::ping()も参照してください 。

[signal] void QWaylandXdgShell::popupCreated(QWaylandXdgPopup *popup, QWaylandXdgSurface *xdgSurface)

このシグナルは、クライアントがxdg_popup を作成したときに発せられます。一般的なユースケースとして、このシグナルのハンドラに、QtQuick シーン内でpopup を表示するために、QWaylandShellSurfaceItemまたはQWaylandQuickItem をインスタンス化させることが挙げられます。

xdgSurface は、popup が役割オブジェクトとして機能するXdgSurface です。

[signal] void QWaylandXdgShell::toplevelCreated(QWaylandXdgToplevel *toplevel, QWaylandXdgSurface *xdgSurface)

このシグナルは、クライアントがxdg_toplevel を作成したときに発火します。一般的な使用例として、このシグナルのハンドラに、QtQuick シーン内でtoplevel を表示するために、QWaylandShellSurfaceItemまたはQWaylandQuickItem をインスタンス化させることが挙げられます。

xdgSurface は、toplevel が役割オブジェクトとして機能するXdgSurface です。

[signal] void QWaylandXdgShell::xdgSurfaceCreated(QWaylandXdgSurface *xdgSurface)

このシグナルは、クライアントがxdg_surface を作成したときに発せられます。なお、xdgSurface はマッピングされていないため、xdg-shell プロトコルに従えば、roleオブジェクトを受信するまでは表示されるべきではないことに注意してください。

toplevelCreated() およびpopupCreated()も参照してください 。

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