このページでは

QWaylandXdgPopup Class

QWaylandXdgPopup クラスは、xdg サーフェスのポップアップ固有の部分を表します。詳細...

ヘッダー: #include <QWaylandXdgPopup>
CMake: find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor)
target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor)
qmake: QT += waylandcompositor
QML内: XdgPopup
継承元: QObject

プロパティ

パブリック関数

Qt::Edges anchorEdges() const
QRect anchorRect() const
QRect configuredGeometry() const
Qt::Orientations flipConstraints() const
Qt::Edges gravityEdges() const
QPoint offset() const
QWaylandXdgSurface *parentXdgSurface() const
QSize positionerSize() const
Qt::Orientations resizeConstraints() const
uint sendConfigure(const QRect &geometry)
void sendPopupDone()
Qt::Orientations slideConstraints() const
QPoint unconstrainedPosition() const
QWaylandXdgSurface *xdgSurface() const

シグナル

静的パブリックメンバー

QWaylandSurfaceRole *role()

詳細な説明

このクラスは、QWaylandXdgShell 拡張機能の一部であり、xdg サーフェス向けのデスクトップスタイルのメニューに特有の機能を用いて、QWaylandXdgSurface の機能を拡張する手段を提供します。

これは、Wayland インターフェースxdg_popup に対応しています。

プロパティのドキュメント

[read-only] anchorEdges : const Qt::Edges

子サーフェスを配置する基準となるアンカー矩形上のエッジの集合を返します。ある方向にエッジが指定されていない場合、アンカーポイントはそれらのエッジの中央に配置されるものとします。

アクセス関数:

Qt::Edges anchorEdges() const

[read-only] anchorRect : const QRect

子サーフェスを配置する基準となる、親ウィンドウのジオメトリを基準としたアンカー矩形を返します。

アクセス関数:

QRect anchorRect() const

[read-only] configuredGeometry : QRect

configure イベントでポップアップが受け取ったウィンドウのジオメトリ。親サーフェスの左上隅を基準としています。

アクセス関数:

QRect configuredGeometry() const

通知シグナル:

void configuredGeometryChanged()

[read-only] flipConstraints : const Qt::Orientations

このプロパティは、子要素が画面内に収まるように反転すべき方向を指定します。

アクセス関数:

Qt::Orientations flipConstraints() const

[read-only] gravityEdges : const Qt::Edges

アンカーポイントに対して、サーフェスをどの方向に配置するかを指定します。

アクセス関数:

Qt::Edges gravityEdges() const

[read-only] offset : const QPoint

アンカー矩形上のアンカーの位置およびサーフェス上のアンカーの位置を基準とした、サーフェス上の位置を返します。

アクセス関数:

QPoint offset() const

[read-only] parentXdgSurface : QWaylandXdgSurface* const

このプロパティには、この `QWaylandXdgPopup` の親に関連付けられた `QWaylandXdgSurface ` が格納されます。

アクセス関数:

QWaylandXdgSurface *parentXdgSurface() const

[read-only] positionerSize : const QSize

ポジショナーオブジェクトによってウィンドウのジオメトリに対して要求されたサイズを返します。

アクセス関数:

QSize positionerSize() const

[read-only] resizeConstraints : const Qt::Orientations

このプロパティは、子要素が画面内に収まるようにサイズ変更される際の向きを指定します。

アクセス関数:

Qt::Orientations resizeConstraints() const

[read-only] slideConstraints : const Qt::Orientations

このプロパティは、子要素が画面内に収まるようにスライドする方向を指定します。

アクセス関数:

Qt::Orientations slideConstraints() const

[read-only] unconstrainedPosition : const QPoint

サーフェスが拘束されていない場合の、親ウィンドウのジオメトリに対するサーフェスの位置。つまり、画面内に収まるよう移動されていない場合などです。

アクセス関数:

QPoint unconstrainedPosition() const

[read-only] xdgSurface : QWaylandXdgSurface* const

このプロパティには、この `QWaylandXdgPopup` に関連付けられた `QWaylandXdgSurface ` が格納されます。

アクセス関数:

QWaylandXdgSurface *xdgSurface() const

メンバ関数のドキュメント

[static] QWaylandSurfaceRole *QWaylandXdgPopup::role()

QWaylandPopup のサーフェス・ロールを返します。

[invokable] uint QWaylandXdgPopup::sendConfigure(const QRect &geometry)

クライアントに構成イベントを送信します。geometry には、親サーフェスのウィンドウジオメトリの左上隅を基準としたウィンドウジオメトリが含まれます。

これにより、対応するQWaylandXdgSurface に対しても暗黙的にconfigureイベントが送信されます。

注:この関数は 、メタオブジェクトシステムを介して、またQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

[invokable] void QWaylandXdgPopup::sendPopupDone()

ポップアップを閉じる。xdg-shell プロトコルによれば、これによりクライアントはポップアップを破棄することになるはずです。

注:この関数は 、メタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

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