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 のウィンドウタイトルを保持する。
シグナル・ドキュメント
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 と関連付ける。
void requestWindowGeometry(int windowState, rect windowGeometry)
新しいwindowState とwindowGeometry をQtShellSurface に要求する。 状態とジオメトリは、クライアントが要求を承認したときに更新される(この時点で、サーフェスのバッファは必要に応じてサイズ変更されていると考えてよい)。
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.