QWaylandXdgToplevel Class
QWaylandXdgToplevel クラスは、xdg サーフェスのトップレベルウィンドウに固有の部分を表します。詳細...
| ヘッダー: | #include <QWaylandXdgToplevel> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS WaylandCompositor) target_link_libraries(mytarget PRIVATE Qt6::WaylandCompositor) |
| qmake: | QT += waylandcompositor |
| QML内: | XdgToplevel |
| 継承元: | QObject |
パブリック型
| enum | DecorationMode { ServerSideDecoration, ClientSideDecoration } |
プロパティ
|
|
パブリック関数
| QWaylandXdgToplevel(QWaylandXdgSurface *xdgSurface, QWaylandResource &resource) | |
| bool | activated() const |
| QString | appId() const |
| QWaylandXdgToplevel::DecorationMode | decorationMode() const |
| bool | fullscreen() const |
| bool | isModal() const |
| QSize | maxSize() const |
| bool | maximized() const |
| QSize | minSize() const |
| QWaylandXdgToplevel * | parentToplevel() const |
| bool | resizing() const |
| void | sendClose() |
| uint | sendConfigure(const QSize &size, const QList<QWaylandXdgToplevel::State> &states) |
| uint | sendFullscreen(const QSize &size) |
| uint | sendMaximized(const QSize &size) |
| uint | sendResizing(const QSize &size) |
| uint | sendUnmaximized(const QSize &size = QSize(0, 0)) |
| QSize | sizeForResize(const QSizeF &size, const QPointF &delta, Qt::Edges edges) const |
| QString | title() const |
| QWaylandXdgSurface * | xdgSurface() const |
シグナル
| void | activatedChanged() |
| void | appIdChanged() |
| void | decorationModeChanged() |
| void | fullscreenChanged() |
| void | maxSizeChanged() |
| void | maximizedChanged() |
| void | minSizeChanged() |
| void | modalChanged() |
| void | parentToplevelChanged() |
| void | resizingChanged() |
| void | statesChanged() |
| void | titleChanged() |
静的パブリックメンバー
| QWaylandXdgToplevel * | fromResource(wl_resource *resource) |
| QWaylandSurfaceRole * | role() |
詳細な説明
このクラスは、QWaylandXdgShell 拡張機能の一部であり、QWaylandXdgSurface の機能を、デスクトップスタイルのウィンドウに特有の機能で拡張する方法を提供します。
これは、Wayland インターフェースxdg_toplevel に対応しています。
メンバ型のドキュメント
enum QWaylandXdgToplevel::DecorationMode
この列挙型は、トップレベルウィンドウのウィンドウ装飾モードを指定するために使用されます。
| 定数 | 定数値 | 説明 |
|---|---|---|
QWaylandXdgToplevel::ServerSideDecoration | 2 | コンポジターはウィンドウ装飾を描画する必要があります。 |
QWaylandXdgToplevel::ClientSideDecoration | 1 | クライアントがウィンドウ装飾を描画する必要があります。 |
プロパティのドキュメント
[read-only] activated : bool
このプロパティは、toplevel が入力フォーカスが当たっている状態として自身を描画しているかどうかを示します。
アクセス関数：
| bool | activated() const |
通知シグナル：
| void | activatedChanged() |
[read-only] appId : QString
このプロパティには、QWaylandXdgToplevel のアプリIDが格納されています。これは、QtにおけるdesktopFileName に対応します。
アクセス関数：
| QString | appId() const |
Notifierシグナル:
| void | appIdChanged() |
[read-only] decorationMode : enum DecorationMode
このプロパティは、このトップレベルウィンドウの現在のウィンドウ装飾モードを保持します。
アクセス関数：
| QWaylandXdgToplevel::DecorationMode | decorationMode() const |
通知シグナル:
| void | decorationModeChanged() |
関連項目: QWaylandXdgDecorationManagerV1 。
[read-only] fullscreen : bool
このプロパティは、クライアントが全画面表示にするべきであることを認識しているかどうかを示します。
アクセス関数：
| bool | fullscreen() const |
Notifierシグナル:
| void | fullscreenChanged() |
[read-only] maxSize : QSize
このプロパティは、QWaylandXdgToplevel の最大サイズを保持します。
コンポジターは、この値を無視して、より大きなサイズを要求することも可能です。
アクセス関数:
| QSize | maxSize() const |
通知シグナル:
| void | maxSizeChanged() |
[read-only] maximized : bool
このプロパティは、クライアントが「最大化すべきである」ことを認識しているかどうかを表します。
アクセス関数：
| bool | maximized() const |
通知シグナル：
| void | maximizedChanged() |
[read-only] minSize : QSize
このプロパティは、QWaylandXdgToplevel の最小サイズを保持します。
コンポジターは、この値を無視して、より小さいサイズを要求することも可能です。
アクセス関数:
| QSize | minSize() const |
通知シグナル:
| void | minSizeChanged() |
[read-only, since 6.8] modal : bool
このプロパティは、トップレベルが他のウィンドウへの入力受信をブロックするかどうかを指定します。
この列挙型は Qt 6.8 で導入されました。
アクセス関数：
| bool | isModal() const |
Notifier シグナル:
| void | modalChanged() |
[read-only] parentToplevel : QWaylandXdgToplevel*
このプロパティには、この `XdgToplevel` の親である `XdgToplevel ` が格納されています。
アクセス関数：
| QWaylandXdgToplevel * | parentToplevel() const |
通知信号：
| void | parentToplevelChanged() |
[read-only] resizing : bool
このプロパティは、クライアントがサイズ変更されていることを認識しているかどうかを示します。
アクセス関数：
| bool | resizing() const |
通知シグナル：
| void | resizingChanged() |
[read-only] states : QList<int>
このプロパティには、クライアントがこの QWaylandToplevel に対して最後に確認応答した状態が格納されます。
Notifierシグナル:
| void | statesChanged() |
[read-only] title : QString
この物件は、「QWaylandXdgToplevel 」の称号を保持しています。
アクセス機能：
| QString | title() const |
通知信号：
| void | titleChanged() |
[read-only] xdgSurface : QWaylandXdgSurface* const
このプロパティは、このQWaylandXdgToplevel に対する「QWaylandXdgSurface 」を保持しています。
アクセス関数：
| QWaylandXdgSurface * | xdgSurface() const |
メンバー関数のドキュメント
[explicit] QWaylandXdgToplevel::QWaylandXdgToplevel(QWaylandXdgSurface *xdgSurface, QWaylandResource &resource)
指定されたxdgSurface およびresource に対して、QWaylandXdgToplevelを構築します。
[static] QWaylandXdgToplevel *QWaylandXdgToplevel::fromResource(wl_resource *resource)
resource に対応するQWaylandXdgToplevel を返します。
[static] QWaylandSurfaceRole *QWaylandXdgToplevel::role()
QWaylandToplevel のサーフェス・ロールを返します。
[invokable] void QWaylandXdgToplevel::sendClose()
クライアントに閉じるイベントを送信します。クライアントは、このイベントを無視することもできます。
注：この関数は 、メタオブジェクトシステムおよびQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
uint QWaylandXdgToplevel::sendConfigure(const QSize &size, const QList<QWaylandXdgToplevel::State> &states)
クライアントに設定イベントを送信します。パラメータ `size ` には、サーフェスのピクセルサイズが格納されます。サイズが 0 の場合は、クライアントがサイズを自由に決定できることを意味します。既知の `states ` は、`QWaylandXdgToplevel::State` に列挙されています。
[invokable] uint QWaylandXdgToplevel::sendFullscreen(const QSize &size)
フルスクリーン状態が設定された状態で「configure」イベントを送信しやすくするため、最大化およびサイズ変更の処理を削除しました。アクティブ状態は現在のまま維持されます。
size はウィンドウの新しいサイズです。
注：この関数は 、メタオブジェクトシステムおよびQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
sendUnmaximizedも参照してください 。
[invokable] uint QWaylandXdgToplevel::sendMaximized(const QSize &size)
最大化状態が設定された状態で「configure」イベントを送信し、フルスクリーンおよびサイズ変更の処理を削除する機能です。アクティブ状態は現在のまま維持されます。
size はウィンドウの新しいサイズです。
注：この関数は 、メタオブジェクトシステムおよびQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
[invokable] uint QWaylandXdgToplevel::sendResizing(const QSize &size)
リサイズ状態が設定され、最大化および全画面表示が解除された状態で、configureイベントを送信するのに便利です。アクティブ状態は現在のまま維持されます。
size はウィンドウの新しいサイズです。
注：この関数は 、メタオブジェクトシステムおよび QML から呼び出すことができます。Q_INVOKABLE を参照してください。
[invokable] uint QWaylandXdgToplevel::sendUnmaximized(const QSize &size = QSize(0, 0))
「最大化」、「全画面表示」、「サイズ変更」の状態を除外して configure イベントを送信する機能です。「全画面表示」と「サイズ変更」の状態は除外されます。アクティブ状態は現在のまま維持されます。
size はウィンドウの新しいサイズです。size がゼロの場合、サイズはクライアント側で決定されます。
注：この関数は 、メタオブジェクトシステムおよびQMLから呼び出すことができます。Q_INVOKABLE を参照してください。
[invokable] QSize QWaylandXdgToplevel::sizeForResize(const QSizeF &size, const QPointF &delta, Qt::Edges edges) const
現在のsize 、delta 、およびドラッグ中にアクティブなedges が与えられた場合、新しいサイズを計算するための便利な関数です。
注：この関数は 、メタオブジェクトシステムおよび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.
