Back to Qt.io
Contact Us Blog Download Qt

QtShellSurface QML Type

サーフェスを識別し、サイズを変更する簡単な方法を提供します。詳細...

Import Statement: import QtWayland.Compositor.QtShell
Since: Qt 6.3

プロパティ

シグナル

メソッド

詳細説明

この型は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]

クライアントが1つを指定した場合、ウィンドウの最小サイズ。それ以外の場合は無効なサイズです。


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()

クライアントアプリケーションが終了することを要求します。


©2024 The Qt Company Ltd. 本書に含まれるドキュメントの著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。