このページでは

WaylandQuickItem QML Type

WaylandView を表すQt Quick アイテムを提供する

Import Statement: import QtWayland.Compositor
In C++: QWaylandQuickItem
Inherited By:

ShellSurfaceItem

プロパティ

信号

方法

詳細説明

Qt Quick-ベースのWaylandコンポジッタはこの型を使ってクライアントのコンテンツを出力デバイスに表示することができる。これはユーザー入力をクライアントに渡す。

プロパティの説明

bufferLocked : bool

このプロパティは、アイテムのバッファが現在ロックされているかどうかを保持する。バッファがロックされている限り、解放されてクライアントに返されることはありません。

デフォルトはfalseです。

compositor : WaylandCompositor [read-only]

このプロパティは、WaylandQuickItem によってレンダリングされたサーフェスのコンポジターを保持します。

focusOnClick : bool

このプロパティは、WaylandQuickItem がクリックまたはタッチされたときにフォーカスを取るかどうかを指定します。

デフォルトはtrue です。

inputEventsEnabled : bool

このプロパティは、このアイテムに対して入力イベントが有効かどうかを保持する。

true の場合、アイテムはキーボードやマウスイベントなどの入力イベントを処理し、処理する。false の場合、入力イベントは無視される。

origin : enum [read-only]

この特性は、QWaylandQuickItem の原点を保持する。

output : WaylandOutput

このプロパティは、この項目が表示される出力を保持する。

paintEnabled : bool

アイテムが非表示の場合、テクスチャは更新されますが、true を返します。visiblefalse に設定してアイテムを非表示にするのとは対照的に、このプロパティをfalse に設定しても、マウスやキーボード入力がアイテムに到達するのを妨げることはありません。

subsurfaceHandler : object

このプロパティは、デフォルトのサブサーフェス動作をオーバーライドする方法を提供します。

デフォルトでは、Qt はこのアイテムの子として新しい SurfaceItem を作成し、正しい位置を維持します。

デフォルトをオーバーライドするには、このプロパティにハンドラオブジェクトを割り当てます。ハンドラは、handleSubsurfaceAdded(WaylandSurface) 関数を実装する必要があります。

ShellSurfaceItem {
    subsurfaceHandler: QtObject {
        function handleSubsurfaceAdded(child) {
          // create custom surface item, and connect the subsurfacePositionChanged signal
        }
    }
}

このプロパティのデフォルト値はnull です。

surface : WaylandSurface

このプロパティは、WaylandQuickItem によってレンダリングされた表面を保持する。

touchEventsEnabled : bool

このプロパティは、タッチイベントがクライアントサーフェスに転送される場合はtrue を保持し、そうでない場合はfalse を保持する。

シグナルのドキュメント

void surfaceDestroyed()

このシグナルは、クライアントがWaylandQuickItem に関連付けられたwl_surface を破棄したときに発行される。このシグナルのハンドラは、WaylandQuickItem を直ちに破棄するか、クローズアニメーションを開始してからアイテムを破棄することが期待される。

アニメーションが開始された場合、アニメーションが終了するまでアイテムのコンテンツが保持されるように、bufferLocked

注: 対応するハンドラはonSurfaceDestroyed です。

bufferLockedも参照してください

メソッドのドキュメント

point mapFromSurface(point point)

Wayland サーフェスの座標系で指定されたpoint を、このアイテムの座標系で等価な点にマップし、マップされた座標を返す。

point mapToSurface(point point)

このアイテムの座標系で与えられたpoint を Wayland サーフェスの座標系で等価な点にマップし、マップされた座標を返す。

void setPrimary()

このWaylandQuickItem をサーフェスのプライマリビューにする。

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