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 |
クライアントがウィンドウの最大サイズを指定している場合は、そのサイズ。それ以外の場合は無効なサイズです。
minimumSize : size |
クライアントが1つを指定した場合、ウィンドウの最小サイズ。それ以外の場合は無効なサイズです。
surface : WaylandSurface |
このプロパティは、このQtShellSurface に関連付けられているサーフェスを保持します。
windowFlags : int |
このプロパティは、QtShellSurface のウィンドウ フラグを保持します。
windowGeometry : rect |
このプロパティはシェル サーフェスのウィンドウ ジオメトリを保持します。
windowPosition : point |
このプロパティは、シェルサーフェスの出力に対する相対位置を保持します。
windowState : int |
このプロパティは、QtShellSurface のウィンドウ状態を保持します。
注意: サーフェスの状態を更新するためにrequestWindowGeometry() が呼び出されると、クライアントが状態の変更を確認するまでwindowState プロパティは更新されません。
windowTitle : string |
このプロパティは、QtShellSurface のウィンドウ・タイトルを保持する。
シグナル・ドキュメント
void startMove() |
クライアントがQWindow::startSystemMove() を呼び出して、コンポジターのインタラクティブな移動操作を要求した。
注： 対応するハンドラはonStartMove 。
capabilitiesも参照してください 。
void startResize(enum edges) |
クライアントがQWindow::startSystemResize() を呼び出して、コンポジター内でインタラクティブなサイズ変更操作を要求した。
edges は、リサイズ中にウィンドウのどの辺を移動させるかについての情報を提供する。これは以下の値のマスクです：
- Qt.TopEdge
- Qt.LeftEdge
- Qt.RightEdge
- Qt.BottomEdge
注意： 対応するハンドラはonStartResize です。
capabilitiesも参照して ください。
メソッド・ドキュメント
void initialize(QtShell qtShell, WaylandSurface surface, WaylandResource resource) |
QtShellSurface を初期化し、与えられたqtShell 、surface 、resource と関連付けます。
新しいwindowState とwindowGeometry をQtShellSurface に要求します。クライアントが要求を確認すると、状態とジオメトリが更新されます（この時点で、必要に応じてサーフェスのバッファのサイズが変更されていると考えても問題ありません）。
void sendClose() |
クライアントアプリケーションが終了することを要求する。
© 2025 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.
