XdgToplevel QML Type

XdgToplevel représente les éléments spécifiques à la fenêtre de niveau supérieur d'une surface xdg. En savoir plus...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• activated : bool
• appId : string
• decorationMode : enumeration
• fullscreen : bool
• maxSize : size
• maximized : bool
• minSize : size
• modal : bool (since 6.8)
• parentToplevel : XdgToplevel
• resizing : bool
• title : string
• xdgSurface : XdgSurface

Méthodes

• void sendClose()
• int sendConfigure(size size, list<int> states)
• void sendFullscreen(size size)
• void sendMaximized(size size)
• void sendResizing(size size)
• void sendUnmaximized(size size)
• size sizeForResize(size size, point delta, uint edges)

Description détaillée

Ce type fait partie de l'extension XdgShell et permet d'étendre les fonctionnalités d'un XdgSurface avec des fonctionnalités spécifiques aux fenêtres de type bureau.

Il correspond à l’interface Wayland xdg_toplevel.

Documentation des propriétés

activated : bool [read-only]

Cette propriété indique si « toplevel » s'affiche comme ayant le focus.

appId : string [read-only]

Cette propriété contient l'identifiant de l'application de XdgToplevel. Elle correspond à la propriété « desktopFileName » dans Qt XML.

decorationMode : enumeration [read-only]

Cette propriété contient le mode de décoration de fenêtre actuel pour cet élément de niveau supérieur.

Les valeurs possibles sont :

Voir également XdgDecorationManagerV1.

fullscreen : bool [read-only]

Cette propriété indique si le client a indiqué qu'il souhaitait passer en mode plein écran.

maxSize : size [read-only]

Cette propriété contient la taille maximale de l'XdgToplevel, telle que demandée par le client.

Le compositeur est libre d'ignorer cette valeur et de demander une taille supérieure.

maximized : bool [read-only]

Cette propriété s'applique, que le client ait ou non indiqué qu'elle devait être maximisée.

minSize : size [read-only]

Cette propriété contient la taille minimale de l’ XdgToplevel, telle que demandée par le client.

Le compositeur est libre d'ignorer cette valeur et de demander une taille inférieure.

modal : bool [read-only, since 6.8]

Cette propriété détermine si le bloc de niveau supérieur empêche les autres fenêtres de recevoir des entrées.

Cette propriété a été introduite dans Qt 6.8.

parentToplevel : XdgToplevel [read-only]

Cette propriété contient l'objet parent « XdgToplevel » de cet objet « XdgToplevel ».

resizing : bool [read-only]

Cette propriété indique si le client a pris en compte le fait que sa taille est en cours de modification.

title : string [read-only]

Cet établissement détient le titre « XdgToplevel ».

xdgSurface : XdgSurface [read-only]

Cette propriété contient l'XdgSurface s relatives à cette XdgToplevel.

Documentation sur les méthodes

void sendClose()

Envoie un événement de fermeture au client. Le client peut choisir d'ignorer cet événement.

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

Envoie un événement de configuration au client. ` size ` contient la taille en pixels de la surface. Une valeur égale à zéro signifie que le client est libre de choisir la taille.

Les valeurs possibles pour ` states ` sont les suivantes :

void sendFullscreen(size size)

Fonctionnalité permettant d'envoyer un événement « configure » avec l'état « plein écran » défini, et les options « agrandissement » et « redimensionnement » désactivées. L'état « activé » conserve sa valeur actuelle.

size correspond à la nouvelle taille de la fenêtre.

Voir également sendUnmaximized.

void sendMaximized(size size)

Fonctionnalité permettant d'envoyer un événement « configure » avec l'état « maximisé » défini, et les options « plein écran » et « redimensionnement » désactivées. L'état « activé » conserve sa valeur actuelle.

size correspond à la nouvelle taille de la fenêtre.

void sendResizing(size size)

Fonctionnalité permettant d'envoyer un événement « configure » avec l'état de redimensionnement défini, et les états « maximisé » et « plein écran » supprimés. L'état « activé » conserve sa valeur actuelle.

size correspond à la nouvelle taille de la fenêtre.

void sendUnmaximized(size size)

Fonctionnalité permettant d'envoyer un événement de configuration en supprimant les états « maximisé », « plein écran » et « redimensionnement », ainsi que les états « plein écran » et « redimensionnement ». L'état « activé » reste inchangé.

size est la nouvelle taille de la fenêtre. Si size est égal à zéro, c’est le client qui détermine la taille.

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

Formule pratique permettant de calculer la nouvelle taille à partir de l'size, d'un delta et de la edges en vigueur dans la traînée.