このページでは

WaylandSurface QML Type (Uncreatable)

出力デバイス上の長方形の領域を表します。詳細...

Import Statement: import QtWayland.Compositor
In C++: QWaylandSurface

注:これは作成不可能な型です。QMLではインスタンス化できません。

プロパティ

信号

方法

詳細な説明

この型は、出力デバイス上に表示されるピクセルの矩形領域をカプセル化します。これは、Waylandプロトコルにおけるwl_surface インターフェースに対応しています。

プロパティのドキュメント

bufferScale : size [read-only]

このプロパティには、WaylandSurface のバッファスケールが格納されます。バッファスケールを使用すると、クライアントは高解像度の出力に使用する高解像度のバッファデータを指定することができます。

bufferSize : size [read-only]

このプロパティは、このWaylandSurface の現在のバッファのサイズを、サーフェス座標ではなくピクセル単位で保持します。

サーフェス座標でのサイズについては、代わりに `destinationSize ` を使用してください。

「 destinationSize 」および「bufferScale 」も参照してください 。

client : WaylandClient [read-only]

このプロパティには、WaylandSurface を使用しているクライアントが保持されます。

contentOrientation : enum [read-only]

このプロパティは、WaylandSurface のコンテンツの向きを保持します。

「WaylandOutput.transform」も参照してください 。

cursorSurface : bool

このプロパティは、WaylandSurface がカーソルサーフェスであるかどうかにかかわらず成立します。

destinationSize : size [read-only]

このプロパティは、表面座標系におけるこのWaylandSurface のサイズを保持します。

「 bufferScale 」および「bufferSize 」も参照してください 。

hasContent : bool [read-only]

このプロパティは、そのサーフェスが現在、コミット済みの、null ではないバッファを持っているかどうかを示します。

WaylandSurface::bufferSizeも参照してください 。

inhibitsIdle : bool [read-only]

このプロパティは、このサーフェスが、画面の消灯、ロック、スクリーンセーバーなどのコンポジターのアイドル動作を抑制することを意図しているかどうかを示します。

IdleInhibitManagerV1も参照してください 。

isOpaque : bool [read-only, since 6.4]

このプロパティは、set_opaque_region リクエストを通じてクライアントから報告されたとおり、サーフェスが完全に不透明であるかどうかを表します。

このプロパティは Qt 6.4 で導入されました。

origin : enum [read-only]

このプロパティには、WaylandSurface のバッファの原点が格納されます。サーフェスにバッファがない場合は、WaylandSurface.OriginTopLeftが格納されます。

このプロパティには、以下の値が設定可能です。

  • WaylandSurface.OriginTopLeft 原点はバッファの左上隅です。
  • WaylandSurface.OriginBottomLeft:原点はバッファの左下隅です。

sourceGeometry : rect [read-only]

このプロパティは、画面に描画されるべき、添付されたWaylandバッファの一部を指定します。座標はバッファの隅を起点としており、bufferScale によってスケーリングされます。

bufferScale 、bufferSize 、およびdestinationSizeも参照してください 。

useTextureAlpha : bool [default: true]

このプロパティは、サーフェスがブレンドにテクスチャのアルファ値を使用するかどうかを指定します。

true の場合、サーフェスのアルファチャンネルがブレンディングに使用されます。false の場合、サーフェスは不透明として扱われます。

Signal ドキュメント

childAdded(WaylandSurface child)

このシグナルは、wl_subsurface(child )がサーフェスに追加されたときに発火します。

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

void dragStarted(WaylandDrag drag)

このシグナルは、drag がこのサーフェスから起動されたときに発せられます。

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

surfaceDestroyed()

このシグナルは、対応する wl_surface が破棄されたときに発せられます。

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

メソッドのドキュメント

void destroy()

WaylandSurface を削除します。

void initialize(WaylandCompositor compositor, WaylandClient client, int id, int version)

指定されたcompositor およびclient 、ならびに指定されたid およびversion を用いて、WaylandSurface を初期化します。

bool isDestroyed()

WaylandSurface が破棄されている場合は、true を返します。それ以外の場合は、false を返します。

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