QtShellChrome QML Type

qt-shell 拡張モジュールで使用するデフォルトのウィンドウマネージャ機能を提供します。詳細...

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

プロパティ

方法

詳しい説明

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 の上マージンのサイズを設定します。デフォルトでは、これはleftResizeHandletitleBar の高さの合計に等しくなります。そうでない場合は0になります。

注意: このプロパティを明示的に設定することで、すべてのデフォルトのフレームマージンは、対応するプロパティで上書きされます。


hasDecorations : bool [read-only]

このプロパティは、ウィンドウの状態とウィンドウ・フラグに基づいて、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 を管理する。アイテムのshellSurfaceQtShellSurface タイプであることが期待される。

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 [read-only]

このプロパティは、QtShellChrome のウィンドウ・フラグを保持します。これらは、関連するQtShellSurfacewindowFlags プロパティと一致します。この場合、代わりにデフォルトのウィンドウ・フラグのセットが使用されます。デフォルトのウィンドウフラグは Qt.Window、Qt.WindowMaximizeButtonHint、Qt.WindowMinimizeButtonHint、Qt.WindowCloseButtonHint です。


windowState : int [read-only]

このプロパティはシェルサーフェスのウィンドウの状態を保持します。ウィンドウの状態がコンポジター側で要求されると、クライアントによって確認される前に、即座に更新されます。そのため、シェルサーフェスの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.