WaylandQuickItem QML Type
WaylandQuickItem 型は、Wayland クライアントの画面を表す「Qt Quick 」アイテムを提供します。詳細...
| Import Statement: | import QtWayland.Compositor |
| In C++: | QWaylandQuickItem |
| Inherited By: |
プロパティ
- bufferLocked : bool
- compositor : WaylandCompositor
- focusOnClick : bool
- inputEventsEnabled : bool
- origin : enum
- output : WaylandOutput
- paintEnabled : bool
- subsurfaceHandler : object
- surface : WaylandSurface
- touchEventsEnabled : bool
信号
- void surfaceDestroyed()
方法
- point mapFromSurface(point point)
- point mapToSurface(point point)
- void setPrimary()
詳細な説明
Qt QuickWaylandベースのコンポジターは、この型を使用してクライアントのコンテンツを出力デバイスに表示できます。また、ユーザー入力をクライアントに渡します。
プロパティのドキュメント
bufferLocked : bool
このプロパティは、項目のバッファが現在ロックされているかどうかを示します。バッファがロックされている限り、バッファは解放されず、クライアントに返されません。
デフォルト値は false です。
compositor : WaylandCompositor [read-only]
このプロパティには、このWaylandQuickItem によってレンダリングされるサーフェスのコンポジターが格納されます。
focusOnClick : bool
このプロパティは、WaylandQuickItem がクリックまたはタップされた際にフォーカスを取得するかどうかを指定します。
デフォルトは `true` です。
inputEventsEnabled : bool
このプロパティは、このアイテムで入力イベントが有効になっているかどうかを示します。
true の場合、そのアイテムはキーボードやマウスなどの入力イベントを処理および対応します。false の場合、入力イベントは無視されます。
origin : enum [read-only]
このプロパティは、サーフェスの現在のバッファの原点を表します。つまり、バッファのどの角が座標 (0, 0) に対応するかを示します。
「WaylandSurface::origin」も参照してください 。
output : WaylandOutput
このプロパティには、このアイテムが表示される出力先が格納されます。
paintEnabled : bool [default: true]
このプロパティを `false ` に設定すると、項目のレンダリングが停止します。visible を `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 ` を直ちに破棄するか、閉じるアニメーションを開始してから `Item` を破棄する必要があります。
アニメーションが開始された場合、アニメーションが終了するまでアイテムがコンテンツを維持できるよう、bufferLocked を設定する必要があります。
注: 対応するハンドラは onSurfaceDestroyed です。
「bufferLocked」も参照してください 。
メソッドのドキュメント
point mapFromSurface(point point)
指定されたpoint を、Waylandサーフェスの座標系からこの項目の座標系内の対応する点にマッピングし、マッピングされた座標を返します。
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.