このページでは

XdgToplevel QML Type

XdgToplevel は、xdg サーフェスの最上位ウィンドウ固有の部分を表します。詳細...

Import Statement: import QtWayland.Compositor.XdgShell
In C++: QWaylandXdgToplevel

プロパティ

方法

詳細な説明

この型は、XdgShell 拡張機能の一部であり、XdgSurface の機能を、デスクトップスタイルのウィンドウに特有の機能で拡張する手段を提供します。

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

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

activated : bool [read-only]

このプロパティは、トップレベルが自身を入力フォーカスが当たっている状態として描画しているかどうかを表します。

appId : string [read-only]

このプロパティには、XdgToplevel のアプリIDが格納されています。これは、QtにおけるdesktopFileName に対応します。

decorationMode : enumeration [read-only]

このプロパティは、このトップレベルウィンドウの現在のウィンドウ装飾モードを保持します。

取り得る値は以下の通りです:

定数説明
XdgToplevel.ServerSideDecorationコンポジターはウィンドウ装飾を描画する必要があります。
XdgToplevel.ClientSideDecorationクライアントがウィンドウ装飾を描画する必要があります。

XdgDecorationManagerV1も参照してください 。

fullscreen : bool [read-only]

このプロパティは、クライアントがフルスクリーンにするべきであることを認識しているかどうかにかかわらず、有効です。

maxSize : size [read-only]

このプロパティには、クライアントから要求されたXdgToplevel の最大サイズが格納されます。

コンポジターは、この値を無視して、より大きなサイズを要求することも可能です。

maximized : bool [read-only]

このプロパティは、クライアントがこれを最大化する必要があることを認識しているかどうかにかかわらず、有効です。

minSize : size [read-only]

このプロパティには、クライアントから要求されたXdgToplevel の最小サイズが格納されます。

コンポジターは、この値を無視して、より小さいサイズを要求することも可能です。

このプロパティは、トップレベルが他のウィンドウへの入力を受け取るのをブロックするかどうかを指定します。

このプロパティは Qt 6.8 で導入されました。

parentToplevel : XdgToplevel [read-only]

このプロパティには、この `XdgToplevel` の親である `XdgToplevel ` が格納されています。

resizing : bool [read-only]

このプロパティは、クライアントがサイズ変更されていることを認識しているかどうかにかかわらず、その値を保持します。

title : string [read-only]

この物件は、「XdgToplevel 」の称号を有しています。

xdgSurface : XdgSurface [read-only]

このプロパティは、このXdgToplevel に対するXdgSurface を保持します。

メソッドのドキュメント

void sendClose()

クライアントに終了イベントを送信します。クライアントはこのイベントを無視することもできます。

int sendConfigure(size size, list<int> states)

クライアントに設定イベントを送信します。size には、サーフェスのピクセルサイズが含まれます。サイズが0の場合は、クライアントが自由にサイズを決定できることを意味します。

states の取り得る値は次のとおりです:

定数説明
XdgToplevel.MaximizedStateサーフェスが最大化されている
XdgToplevel.FullscreenStateサーフェスがフルスクリーン状態
XdgToplevel.ResizingStateサーフェスのサイズ変更中
XdgToplevel.ActivatedStateサーフェスがアクティブになりました

void sendFullscreen(size size)

フルスクリーン状態が設定された状態で「configure」イベントを送信しやすくするため、最大化およびサイズ変更の処理が削除されました。アクティブ状態は現在のまま維持されます。

size はウィンドウの新しいサイズです。

sendUnmaximizedも参照してください 。

void sendMaximized(size size)

最大化状態が設定された状態で「configure」イベントを送信できるようにした利便性であり、フルスクリーンおよびサイズ変更の処理は削除されています。アクティブ状態は現在のまま維持されます。

size はウィンドウの新しいサイズです。

void sendResizing(size size)

リサイズ状態が設定された状態で、最大化および全画面表示が解除された状態で、configureイベントを送信するための便利な機能です。アクティブ状態は現在のまま維持されます。

size はウィンドウの新しいサイズです。

void sendUnmaximized(size size)

「最大化」「全画面表示」「サイズ変更」の状態を除外して configure イベントを送信するための便利な機能です。「全画面表示」と「サイズ変更」の状態は除外されますが、「アクティブ」の状態は現在のまま維持されます。

size はウィンドウの新しいサイズです。size がゼロの場合、サイズはクライアントが決定します。

size sizeForResize(size size, point delta, uint edges)

現在のsize 、delta 、およびドラッグ中にアクティブなedges が与えられた場合、新しいサイズを計算するための便利な方法。

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