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も参照してください。

プロパティの説明

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 `[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 を管理する。アイテムの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 `[read-only]`

このプロパティは、QtShellChrome のウィンドウ・フラグを保持します。これらのフラグは、関連するQtShellSurface のwindowFlags プロパティと一致します。この場合、代わりにデフォルトのウィンドウ・フラグのセットが使用されます。デフォルトのウィンドウフラグは 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()

最小化状態と通常状態を切り替える。このメソッドはまた、ウィンドウの最大化状態が設定されている場合は、それをクリアする。

© 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.

QtShellChrome QML Type

プロパティ

方法

詳しい説明

プロパティの説明

bottomLeftResizeHandle : Item

bottomResizeHandle : Item

bottomRightResizeHandle : Item

frameMarginBottom : int

frameMarginLeft : int

frameMarginRight : int

frameMarginTop : int

hasDecorations : bool [read-only]

leftResizeHandle : Item

maximizedRect : rect

rightResizeHandle : Item

shellSurfaceItem : ShellSurfaceItem

titleBar : Item

topLeftResizeHandle : Item

topResizeHandle : Item

topRightResizeHandle : Item

windowFlags : int [read-only]

windowState : int [read-only]

メソッドのドキュメント

void activate()

void deactivate()

void lower()

void raise()

void toggleFullScreen()

void toggleMaximized()

void toggleMinimized()

hasDecorations : bool `[read-only]`

windowFlags : int `[read-only]`

windowState : int `[read-only]`