XdgPopup QML Type
XdgPopup は、xdg サーフェスのポップアップ固有の部分を表します。詳細...
| Import Statement: | import QtWayland.Compositor.XdgShell |
| In C++: | QWaylandXdgPopup |
プロパティ
- anchorEdges : enumeration
- anchorRect : rect
- configuredGeometry : rect
- flipConstraints : enumeration
- gravityEdges : rect
- offset : point
- parentXdgSurface : XdgSurface
- positionerSize : size
- resizeConstraints : enumeration
- slideConstraints : enumeration
- unconstrainedPosition : point
- xdgSurface : XdgSurface
方法
- int sendConfigure(rect geometry)
- void sendPopupDone()
詳細な説明
この型は、XdgShell 拡張機能の一部であり、xdg サーフェス向けのデスクトップスタイルのメニューに特有の機能を用いて、XdgSurface の機能を拡張する手段を提供します。
これは、Wayland インターフェースxdg_popup に対応しています。
プロパティのドキュメント
anchorEdges : enumeration [read-only]
このプロパティは、子サーフェスを配置する際の基準となるアンカー矩形上のエッジの集合を保持します。ある方向についてエッジが指定されていない場合、アンカーポイントはそれらのエッジの中央に配置されます。
取り得る値は以下の通りです:
| 定数 | 説明 |
|---|---|
Qt.TopEdge | 矩形の上辺。 |
Qt.LeftEdge | 矩形の左端。 |
Qt.RightEdge | 長方形の右端。 |
Qt.BottomEdge | 長方形の底辺。 |
anchorRect : rect [read-only]
子サーフェスを配置する際の基準となる、親ウィンドウのジオメトリに対するアンカー矩形。
configuredGeometry : rect [read-only]
configure イベントでポップアップが受け取ったウィンドウのジオメトリ。親サーフェスの左上隅を基準としています。
flipConstraints : enumeration [read-only]
このプロパティは、子要素が画面内に収まるように反転すべき向きを指定します。
取り得る値:
| 定数 | 説明 |
|---|---|
Qt.Horizontal | 水平 |
Qt.Vertical | 垂直 |
gravityEdges : rect [read-only]
アンカーポイントに対して、サーフェスをどの方向に配置するかを指定します。
指定可能な値は次のとおりです:
| 定数 | 説明 |
|---|---|
Qt.TopEdge | サーフェスは画面の上部に向かってスライドする。 |
Qt.LeftEdge | サーフェスは画面の左側に向かってスライドします。 |
Qt.RightEdge | サーフェスは画面の右側に向かってスライドする。 |
Qt.BottomEdge | 面は画面の下部に向かってスライドする。 |
offset : point [read-only]
アンカー矩形上のアンカーの位置および表面上のアンカーの位置に対する相対的な位置。
parentXdgSurface : XdgSurface [read-only]
このプロパティには、この `XdgPopup` の親に関連付けられた `XdgSurface ` が格納されています。
positionerSize : size [read-only]
ポジショナーオブジェクトがウィンドウのジオメトリに対して要求したサイズ。
resizeConstraints : enumeration [read-only]
このプロパティは、子要素が画面内に収まるようにサイズ変更される際の向きを指定します。
取り得る値:
| 定数 | 説明 |
|---|---|
Qt.Horizontal | 水平 |
Qt.Vertical | 垂直 |
slideConstraints : enumeration [read-only]
このプロパティは、子要素が画面内に収まるようにスライドする方向を指定します。
取り得る値:
| 定数 | 説明 |
|---|---|
Qt.Horizontal | 水平 |
Qt.Vertical | 垂直 |
unconstrainedPosition : point [read-only]
サーフェスが拘束されていない場合の、親ウィンドウのジオメトリに対するそのサーフェスの位置。つまり、画面内に収まるように移動されていない場合などです。
xdgSurface : XdgSurface [read-only]
このプロパティには、この `XdgPopup` に関連付けられた `XdgSurface ` が格納されます。
メソッドのドキュメント
int sendConfigure(rect geometry)
クライアントに構成イベントを送信します。geometry には、親サーフェスのウィンドウ形状の左上隅を基準とした相対的なウィンドウ形状が含まれます。
これにより、対応するXdgSurface に対しても暗黙的にconfigureイベントが送信されます。
void sendPopupDone()
ポップアップを閉じる。xdg-shell プロトコルによれば、これによりクライアントはポップアップを破棄するはずです。
© 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.