QtShellChrome QML Type
qt-shell
拡張モジュールで使用するデフォルトのウィンドウマネージャ機能を提供します。詳細...
Import Statement: | import QtWayland.Compositor.QtShell |
Since: | Qt 6.3 |
プロパティ
- bottomLeftResizeHandle : Item
- bottomResizeHandle : Item
- bottomRightResizeHandle : Item
- frameMarginBottom : int
- frameMarginLeft : int
- frameMarginRight : int
- frameMarginTop : int
- hasDecorations : bool
- leftResizeHandle : Item
- maximizedRect : rect
- rightResizeHandle : Item
- shellSurfaceItem : ShellSurfaceItem
- titleBar : Item
- topLeftResizeHandle : Item
- topResizeHandle : Item
- topRightResizeHandle : Item
- windowFlags : int
- windowState : int
方法
- void activate()
- void deactivate()
- void lower()
- void raise()
- void toggleFullScreen()
- void toggleMaximized()
- void toggleMinimized()
詳しい説明
QtShellChrome は、qt-shell
シェル拡張プロトコルを介したクライアントとのインタラクションにウィンドウマネージャ機能を提供するために使用できる便利な型です。
関連するQtShellSurface を持つShellSurfaceItem が与えられると、このアイテムは自動的にそのサイズを表面に合わせます。また、以下の自動処理も提供します:
- 最大化、最小化、フルスクリーンなどのウィンドウの状態。
- ウィンドウのアクティブ化。
- リサイズハンドルを使用したウィンドウのサイズ変更(適切なプロパティが設定されている場合)。
- タイトルバーのインタラクションを使用したウィンドウの再配置(titleBar プロパティが設定されている場合)。
QtShellChrome は、QtShell およびQtShellSurface と共に使用することを意図しています。
QtShell Compositorも参照してください 。
プロパティ Documentation
bottomLeftResizeHandle : Item |
このプロパティは、QtShellChrome のデフォルトの左下のリサイズハンドルを保持します。設定された場合、DragHandler がリサイズハンドルにインストールされ、ウィンドウの下辺と左辺を等しく移動させることでウィンドウのサイズを変更します。
ハンドルは、ウィンドウフラグとウィンドウのフルスクリーン状態に応じて、自動的に非表示と表示になる。
QtShellChrome { Rectangle { id: blrh anchors.bottom: parent.bottom anchors.left: parent.left height: 5 width: 5 color: "white" } bottomLeftResizeHandle: blrh }
bottomResizeHandle : Item |
このプロパティは、QtShellChrome のデフォルトのボトムリサイズハンドルを保持します。 設定された場合、DragHandler は、そのボトムエッジを移動することによってウィンドウのサイズを変更するリサイズハンドルにインストールされます。
ハンドルは、ウィンドウフラグとウィンドウのフルスクリーン状態に応じて、自動的に非表示と表示になる。
QtShellChrome { Rectangle { id: brh anchors.bottom: parent.bottom anchors.left: parent.left anchors.right: parent.right height: 5 color: "white" } bottomResizeHandle: brh }
注意: 明示的なフレームマージンが設定されていない限り、ハンドルの高さはウィンドウの下部フレームマージンに含まれる。
bottomRightResizeHandle : Item |
このプロパティは、QtShellChrome のデフォルトの右下リサイズハンドルを保持します。設定された場合、DragHandler がリサイズハンドルにインストールされ、ウィンドウの下辺と右辺を等しく移動させることでウィンドウのサイズを変更します。
ハンドルは、ウィンドウフラグとウィンドウのフルスクリーン状態に応じて、自動的に隠れたり現れたりする。
QtShellChrome { Rectangle { id: brrh anchors.bottom: parent.bottom anchors.right: parent.right height: 5 width: 5 color: "white" } bottomRightResizeHandle: brrh }
frameMarginBottom : int |
ウィンドウの装飾のために予約されているQtShellChrome の下マージンのサイズを設定します。デフォルトでは、bottomResizeHandle の高さと等しくなります。そうでない場合は0になります。
注意: このプロパティを明示的に設定することで、すべてのデフォルトのフレーム・マージンは対応するプロパティで上書きされます。
frameMarginLeft : int |
QtShellChrome の左マージンのサイズを設定します。これはウィンドウの装飾用に確保されます。デフォルトでは、leftResizeHandle の幅と等しくなります。そうでない場合は0になります。
注意: このプロパティを明示的に設定することで、すべてのデフォルトのフレーム・マージンは対応するプロパティで上書きされます。
frameMarginRight : int |
ウィンドウ装飾用に予約されているQtShellChrome の右マージンのサイズを設定します。デフォルトでは、rightResizeHandle の幅と等しくなります。そうでない場合は0になります。
注意: このプロパティを明示的に設定することで、すべてのデフォルトのフレーム・マージンは対応するプロパティで上書きされます。
frameMarginTop : int |
ウィンドウの装飾用に予約されている、QtShellChrome の上マージンのサイズを設定します。デフォルトでは、これはleftResizeHandle とtitleBar の高さの合計に等しくなります。そうでない場合は0になります。
注意: このプロパティを明示的に設定することで、すべてのデフォルトのフレームマージンは、対応するプロパティで上書きされます。
hasDecorations : bool |
このプロパティは、ウィンドウの状態とウィンドウ・フラグに基づいて、QtShellChrome'の装飾を表示する必要がある場合に真になります。
leftResizeHandle : Item |
このプロパティは、QtShellChrome のデフォルトの左リサイズハンドルを保持する。 設定された場合、DragHandler がリサイズハンドルにインストールされ、ウィンドウの左端を移動することでウィンドウのサイズを変更する。
ハンドルは、ウィンドウフラグとウィンドウのフルスクリーン状態に応じて、自動的に非表示と表示になります。
QtShellChrome { Rectangle { id: lrh anchors.left: parent.left anchors.top: parent.top anchors.bottom: parent.bottom width: 5 color: "white" } leftResizeHandle: lrh }
注意: 明示的なフレームマージンが設定されていない限り、ハンドルの幅はウィンドウの左フレームマージンに含まれる。
maximizedRect : rect |
このプロパティは、ウィンドウが最大化状態にあるときに、ウィンドウによって埋められるWaylandOutput の大きさを保持します。デフォルトでは、ウィンドウが最大化されると、WaylandOutput のジオメトリ全体が満たされます。このプロパティを変更すると、例えば、コンポジターにタスクバーなど、最大化されたアプリケーションによって隠されてはならない他のシステムUIがある場合に便利です。
rightResizeHandle : Item |
このプロパティは、QtShellChrome のデフォルトの右リサイズハンドルを保持します。設定された場合、DragHandler がリサイズハンドルにインストールされ、その右端を移動することでウィンドウのサイズを変更します。
ハンドルは、ウィンドウフラグとウィンドウのフルスクリーン状態に応じて、自動的に非表示と表示になる。
QtShellChrome { Rectangle { id: rrh anchors.right: parent.right anchors.top: parent.top anchors.bottom: parent.bottom width: 5 color: "white" } rightResizeHandle: rrh }
注意: 明示的なフレームマージンが設定されていない限り、ハンドルの幅はウィンドウの右フレームマージンに含まれる。
shellSurfaceItem : ShellSurfaceItem |
このプロパティは、このQtShellChrome に関連付けられたシェルサーフェス項目を保持する。このアイテムのshellSurface
を管理する。アイテムのshellSurface
はQtShellSurface タイプであることが期待される。
QtShellChrome { id: chrome ShellSurfaceItem { id: sfi anchors.fill: parent moveItem: chrome } shellSurfaceItem: sfi }
titleBar : Item |
このプロパティは、QtShellChrome のデフォルトタイトルバーアイテムを保持する。 設定された場合、DragHandler がタイトルバーにインストールされ、ユーザーの操作でウィンドウを移動する。さらに、タイトル・バーがクリックされると、ウィンドウは自動的にアクティブになります。
タイトル・バーは、ウィンドウ・フラグとウィンドウのフル・スクリーンの状態に応じて、自動的に隠れたり現れたりする。
QtShellChrome { Rectangle { id: tb anchors.top: parent.top anchors.right: parent.right anchors.left: parent.left height: 50 color: "black" Text { color: "white" anchors.centerIn: parent text: shellSurfaceItem.shellSurface.windowTitle font.pixelSize: 25 } } titleBar: tb }
注意: 明示的なフレームマージンが設定されていない限り、タイトルバーの高さはウィンドウの上部フレームマージンに含まれます。
topLeftResizeHandle : Item |
このプロパティは、QtShellChrome のデフォルトの左上リサイズハンドルを保持します。設定された場合、DragHandler がリサイズハンドルにインストールされ、ウィンドウの上端と左端を等しく移動させることでウィンドウのサイズを変更します。
ハンドルは、ウィンドウフラグとウィンドウのフルスクリーン状態に応じて、自動的に非表示と表示になる。
QtShellChrome { Rectangle { id: tlrh anchors.top: parent.top anchors.left: parent.left height: 5 width: 5 color: "white" } topLeftResizeHandle: tlrh }
topResizeHandle : Item |
このプロパティは、QtShellChrome のデフォルトのトップリサイズハンドルを保持します。 設定された場合、DragHandler は、そのトップエッジを移動することによってウィンドウのサイズを変更するリサイズハンドルにインストールされます。
ハンドルは、ウィンドウフラグとウィンドウのフルスクリーン状態に応じて、自動的に非表示と表示になる。
QtShellChrome { Rectangle { id: trh anchors.top: parent.top anchors.left: parent.left anchors.right: parent.right height: 5 color: "white" } topResizeHandle: trh }
注意: 明示的なフレームマージンが設定されていない限り、ハンドルの高さはウィンドウの上フレームマージンに含まれる。
topRightResizeHandle : Item |
このプロパティは、QtShellChrome のデフォルトの右上リサイズハンドルを保持します。設定された場合、DragHandler がリサイズハンドルにインストールされ、ウィンドウの上端と右端を等しく移動させることでウィンドウのサイズを変更します。
ハンドルは、ウィンドウフラグとウィンドウのフルスクリーン状態に応じて、自動的に非表示と表示になる。
QtShellChrome { Rectangle { id: trrh anchors.top: parent.top anchors.right: parent.right height: 5 width: 5 color: "white" } topRightResizeHandle: trrh }
windowFlags : int |
このプロパティは、QtShellChrome のウィンドウ・フラグを保持します。これらは、関連するQtShellSurface のwindowFlags
プロパティと一致します。この場合、代わりにデフォルトのウィンドウ・フラグのセットが使用されます。デフォルトのウィンドウフラグは Qt.Window、Qt.WindowMaximizeButtonHint、Qt.WindowMinimizeButtonHint、Qt.WindowCloseButtonHint です。
windowState : int |
このプロパティはシェルサーフェスのウィンドウの状態を保持します。ウィンドウの状態がコンポジター側で要求されると、クライアントによって確認される前に、即座に更新されます。そのため、シェルサーフェスのwindowState
プロパティとは異なる場合があります。
メソッドの説明
void activate() |
このウィンドウを手動でアクティブにします。これにより、ウィンドウも更新されます。
raise()も参照してください 。
void deactivate() |
手動でこのウィンドウを非アクティブにします。ウィンドウがアクティブだった場合、代わりにスタックの次のウィンドウをアクティブにします。
void lower() |
このウィンドウを下げて、他のウィンドウの下にスタックするようにする (他のウィンドウのウィンドウフラグで禁止されている場合を除く)。
void raise() |
このウィンドウを上げると、他のウィンドウの上にスタックされます (他のウィンドウのフラグがこれを禁止している場合を除く)。
void toggleFullScreen() |
フルスクリーンと通常のウィンドウの状態を切り替えます。このメソッドは、最小化または最大化されたウィンドウの状態もクリアします。
void toggleMaximized() |
最大化状態と通常状態を切り替えます。このメソッドはまた、最小化ウィンドウの状態が設定されている場合は、それをクリアします。
void toggleMinimized() |
最小化状態と通常状態を切り替えます。このメソッドは、最大化ウィンドウの状態が設定されている場合は、その状態もクリアします。
© 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.