QtShellSurface QML Type
サーフェスを特定したり、サイズを変更したりするための簡単な方法を提供します。詳細...
| Import Statement: | import QtWayland.Compositor.QtShell |
| Since: | Qt 6.3 |
プロパティ
- active : bool
- capabilities : enum
- frameMarginBottom : int
- frameMarginLeft : int
- frameMarginRight : int
- frameMarginTop : int
- maximumSize : size
- minimumSize : size
- surface : WaylandSurface
- windowFlags : int
- windowGeometry : rect
- windowPosition : point
- windowState : int
- windowTitle : string
信号
- void startMove()
- void startResize(enum edges)
方法
- void initialize(QtShell qtShell, WaylandSurface surface, WaylandResource resource)
- void requestWindowGeometry(int windowState, rect windowGeometry)
- void sendClose()
詳細な説明
この型は「QtShell 」拡張機能の一部であり、既存のWaylandSurface にウィンドウ管理機能を追加する手段を提供します。
QtShellSurface型は、QtShell 拡張機能をサポートするコンポジターを作成するために必要な中核機能を備えています。コンポジターの要件に応じて、直接使用することも、QtShellChrome 型を介して使用することも可能です。QtShellChrome 型には、QtShellSurfaceオブジェクトを操作するためのデフォルトの動作や便利なAPIが用意されています。
プロパティのドキュメント
active : bool
このプロパティは、そのサーフェスが現在アクティブと見なされているかどうかを保持します。
注: QtShellSurface には、複数のサーフェスが同時にアクティブになることを妨げる制限はありません 。そのようなロジックは、コンポジター側で実装するか、サーフェスのアクティブ状態を自動的に管理する `QtShellChrome ` 型を使用する必要があります。
capabilities : enum
このプロパティは、コンポジターの機能を保持します。デフォルトでは、特別な機能は有効になっていません。
- QtShellSurface.InteractiveMove クライアントは、QWindow::startSystemMove() を使用して、サーバー側の対話型移動操作をトリガーできます。これについては、startMove() シグナルを通じてコンポジターに通知されます。
- QtShellSurface.InteractiveResize クライアントは、QWindow::startSystemResize() を使用して、サーバー側のインタラクティブなサイズ変更操作をトリガーできます。これについては、startResize() シグナルを通じてコンポジターに通知されます。
frameMarginBottom : int
これにより、ウィンドウフレームの余白が表面より下側に配置されます。
frameMarginLeft : int
これにより、ウィンドウフレームの余白がサーフェスの左側に固定されます。
frameMarginRight : int
これにより、ウィンドウフレームの余白がサーフェスの右側に固定されます。
frameMarginTop : int
これにより、窓枠が表面から浮いた状態になります。
maximumSize : size [read-only]
クライアントがウィンドウのサイズを指定している場合の、その最大サイズ。指定がない場合は、無効なサイズとなります。
minimumSize : size [read-only]
クライアントがウィンドウのサイズを指定している場合の最小サイズ。指定がない場合は、無効なサイズとなります。
surface : WaylandSurface [read-only]
このプロパティには、このQtShellSurface に関連付けられたサーフェスが格納されています。
windowFlags : int [read-only]
このプロパティには、QtShellSurface のウィンドウフラグが格納されています。
windowGeometry : rect [read-only]
このプロパティには、シェルサーフェスのウィンドウ形状が格納されています。
windowPosition : point
このプロパティは、シェル表面の出力に対する位置を保持します。
windowState : int [read-only]
このプロパティには、QtShellSurface のウィンドウ状態が格納されます。
注: requestWindowGeometry() が呼び出されてサーフェスの状態が更新された場合 、クライアントが状態の変更を承認するまで、windowState プロパティは更新されません。
windowTitle : string [read-only]
このプロパティは、QtShellSurface のウィンドウタイトルを保持します。
Signal ドキュメント
void startMove()
クライアントは、QWindow::startSystemMove() を呼び出すことで、コンポジターでの対話型の移動操作を要求しました。
注: 対応するハンドラは onStartMove です。
「capabilities」も参照してください 。
void startResize(enum edges)
クライアントは、QWindow::startSystemResize() を呼び出すことで、コンポジターでのインタラクティブなサイズ変更操作を要求しました。
edges は、サイズ変更時にウィンドウのどの辺を移動すべきかに関する情報を提供します。これは、以下の値からなるマスクです:
- Qt.TopEdge
- Qt.LeftEdge
- Qt.TopEdge
- Qt.TopEdge
注: 対応するハンドラは `onStartResize` です。
「capabilities」も参照してください 。
メソッドのドキュメント
void initialize(QtShell qtShell, WaylandSurface surface, WaylandResource resource)
QtShellSurface を初期化し、指定されたqtShell 、surface 、およびresource に関連付けます。
void requestWindowGeometry(int windowState, rect windowGeometry)
QtShellSurface に対して、新しい `windowState ` および `windowGeometry ` を要求します。クライアントがこの要求を承認すると、状態とジオメトリが更新されます(この時点で、必要に応じてサーフェスのバッファのサイズ変更が完了していると見なしても差し支えない)。
void sendClose()
クライアントアプリケーションが自ら終了するよう要求します。
© 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.