QtShellChrome QML Type

Fournit la fonctionnalité de gestionnaire de fenêtres par défaut pour l'utilisation de l'extension qt-shell. Plus d'informations...

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

Propriétés

• bottomLeftResizeHandle : Item
• bottomResizeHandle : Item
• bottomRightResizeHandle : Item
• frameMarginBottom : int
• frameMarginLeft : int
• frameMarginRight : int
• frameMarginTop : int
• hasDecorations : bool
• leftResizeHandle : Item
• maximizedRect : rect
• rightResizeHandle : Item
• shellSurfaceItem : ShellSurfaceItem
• titleBar : Item
• topLeftResizeHandle : Item
• topResizeHandle : Item
• topRightResizeHandle : Item
• windowFlags : int
• windowState : int

Méthodes

• void activate()
• void deactivate()
• void lower()
• void raise()
• void toggleFullScreen()
• void toggleMaximized()
• void toggleMinimized()

Description détaillée

QtShellChrome est un type de commodité qui peut être utilisé pour fournir une fonctionnalité de gestionnaire de fenêtre à l'interaction avec les clients via le protocole d'extension shell qt-shell.

Étant donné un ShellSurfaceItem avec un QtShellSurface associé, l'élément adaptera automatiquement sa taille pour correspondre à la surface. Il assurera également la gestion automatique des éléments suivants

• des états de la fenêtre, tels que maximisé, minimisé et plein écran
• L'activation de la fenêtre.
• Redimensionnement de la fenêtre à l'aide des poignées de redimensionnement (si les propriétés appropriées sont définies).
• Le repositionnement de la fenêtre en utilisant l'interaction avec la barre de titre (si la propriété titleBar est définie).

Le QtShellChrome est destiné à être utilisé avec QtShell et QtShellSurface.

Voir aussi QtShell Compositor.

Documentation sur les propriétés

bottomLeftResizeHandle : Item

Cette propriété définit la poignée de redimensionnement en bas à gauche par défaut de la fenêtre QtShellChrome. Si elle est définie, une DragHandler sera installée sur la poignée de redimensionnement qui redimensionne la fenêtre en déplaçant ses bords inférieur et gauche dans des proportions égales.

La poignée se cache et s'affiche automatiquement, en fonction des drapeaux de fenêtre et de l'état plein écran de la fenêtre.

QtShellChrome {
   Rectangle {
       id: blrh
       anchors.bottom: parent.bottom
       anchors.left: parent.left
       height: 5
       width: 5
       color: "white"
   }
   bottomLeftResizeHandle: blrh
}

bottomResizeHandle : Item

Cette propriété définit la poignée de redimensionnement inférieure par défaut de la fenêtre QtShellChrome. Si elle est définie, une DragHandler sera installée sur la poignée de redimensionnement qui redimensionne la fenêtre en déplaçant son bord inférieur.

La poignée se cache et s'affiche automatiquement, en fonction des drapeaux de la fenêtre et de l'état plein écran de la fenêtre.

QtShellChrome {
   Rectangle {
       id: brh
       anchors.bottom: parent.bottom
       anchors.left: parent.left
       anchors.right: parent.right
       height: 5
       color: "white"
   }
   bottomResizeHandle: brh
}

bottomRightResizeHandle : Item

Cette propriété contient la poignée de redimensionnement bas-droite par défaut de QtShellChrome. Si elle est définie, une DragHandler sera installée sur la poignée de redimensionnement qui redimensionne la fenêtre en déplaçant ses bords inférieur et droit dans des proportions égales.

La poignée se cache et s'affiche automatiquement, en fonction des drapeaux de fenêtre et de l'état plein écran de la fenêtre.

QtShellChrome {
   Rectangle {
       id: brrh
       anchors.bottom: parent.bottom
       anchors.right: parent.right
       height: 5
       width: 5
       color: "white"
   }
   bottomRightResizeHandle: brrh
}

frameMarginBottom : int

Définit la taille de la marge inférieure de QtShellChrome qui est réservée aux décorations de la fenêtre. Par défaut, cette marge sera égale à la hauteur du site bottomResizeHandle si elle est définie. Sinon, elle sera égale à 0.

frameMarginLeft : int

Définit la taille de la marge gauche de QtShellChrome qui est réservée aux décorations de la fenêtre. Par défaut, cette marge sera égale à la largeur du site leftResizeHandle si elle est définie. Sinon, elle sera égale à 0.

frameMarginRight : int

Définit la taille de la marge droite de QtShellChrome qui est réservée aux décorations de la fenêtre. Par défaut, cette marge sera égale à la largeur du site rightResizeHandle si elle est définie. Sinon, elle sera égale à 0.

frameMarginTop : int

Définit la taille de la marge supérieure de QtShellChrome qui est réservée aux décorations de la fenêtre. Par défaut, cette taille est égale à la somme des hauteurs de leftResizeHandle et de titleBar, si elles sont définies. Sinon, elle sera égale à 0.

hasDecorations : bool [read-only]

Cette propriété est vraie si les décorations du site QtShellChrome doivent être visibles, en fonction de l'état de la fenêtre et des drapeaux de fenêtre.

leftResizeHandle : Item

Cette propriété définit la poignée de redimensionnement gauche par défaut de la fenêtre QtShellChrome. Si elle est définie, une DragHandler sera installée sur la poignée de redimensionnement qui redimensionne la fenêtre en déplaçant son bord gauche.

La poignée se cache et s'affiche automatiquement, en fonction des drapeaux de la fenêtre et de l'état plein écran de la fenêtre.

QtShellChrome {
   Rectangle {
       id: lrh
       anchors.left: parent.left
       anchors.top: parent.top
       anchors.bottom: parent.bottom
       width: 5
       color: "white"
   }
   leftResizeHandle: lrh
}

maximizedRect : rect

Cette propriété contient la zone du site WaylandOutput qui est disponible pour être remplie par la fenêtre lorsqu'elle est maximisée. Par défaut, la fenêtre remplit toute la géométrie de WaylandOutput lorsqu'elle est maximisée. Il peut être utile de modifier cette propriété, par exemple lorsque le compositeur comporte d'autres interfaces utilisateur qui ne doivent pas être masquées par les applications maximisées, telles que la barre des tâches.

rightResizeHandle : Item

Cette propriété contient la poignée de redimensionnement droite par défaut de la fenêtre QtShellChrome. Si elle est définie, une DragHandler sera installée sur la poignée de redimensionnement qui redimensionne la fenêtre en déplaçant son bord droit.

La poignée se cache et s'affiche automatiquement, en fonction des drapeaux de la fenêtre et de l'état plein écran de la fenêtre.

QtShellChrome {
   Rectangle {
       id: rrh
       anchors.right: parent.right
       anchors.top: parent.top
       anchors.bottom: parent.bottom
       width: 5
       color: "white"
   }
   rightResizeHandle: rrh
}

shellSurfaceItem : ShellSurfaceItem

Cette propriété contient l'élément de surface de coquillage associé à cette QtShellChrome. Elle gérera à son tour le shellSurface de cet élément. Le shellSurface de l'élément est censé être du type QtShellSurface.

QtShellChrome {
   id: chrome
   ShellSurfaceItem {
       id: sfi
       anchors.fill: parent
       moveItem: chrome
   }
   shellSurfaceItem: sfi
}

titleBar : Item

Cette propriété définit l'élément de la barre de titre par défaut de QtShellChrome. Si elle est définie, un DragHandler sera installé sur la barre de titre pour déplacer la fenêtre en fonction de l'interaction de l'utilisateur. En outre, la fenêtre sera automatiquement activée si l'on clique sur la barre de titre.

La barre de titre se cache et s'affiche automatiquement en fonction des drapeaux de la fenêtre et de l'état plein écran de la fenêtre.

QtShellChrome {
   Rectangle {
       id: tb
       anchors.top: parent.top
       anchors.right: parent.right
       anchors.left: parent.left
       height: 50
       color: "black"

       Text {
           color: "white"
           anchors.centerIn: parent
           text: shellSurfaceItem.shellSurface.windowTitle
           font.pixelSize: 25
       }
   }
   titleBar: tb
}

topLeftResizeHandle : Item

Cette propriété contient la poignée de redimensionnement en haut et à gauche par défaut de la fenêtre QtShellChrome. Si elle est définie, une DragHandler sera installée sur la poignée de redimensionnement qui redimensionne la fenêtre en déplaçant ses bords supérieur et gauche dans des proportions égales.

La poignée se cache et s'affiche automatiquement, en fonction des drapeaux de fenêtre et de l'état plein écran de la fenêtre.

QtShellChrome {
   Rectangle {
       id: tlrh
       anchors.top: parent.top
       anchors.left: parent.left
       height: 5
       width: 5
       color: "white"
   }
   topLeftResizeHandle: tlrh
}

topResizeHandle : Item

Cette propriété définit la poignée de redimensionnement supérieure par défaut de la fenêtre QtShellChrome. Si elle est définie, une DragHandler sera installée sur la poignée de redimensionnement qui redimensionne la fenêtre en déplaçant son bord supérieur.

La poignée se cache et s'affiche automatiquement, en fonction des drapeaux de la fenêtre et de l'état plein écran de la fenêtre.

QtShellChrome {
   Rectangle {
       id: trh
       anchors.top: parent.top
       anchors.left: parent.left
       anchors.right: parent.right
       height: 5
       color: "white"
   }
   topResizeHandle: trh
}

topRightResizeHandle : Item

Cette propriété contient la poignée de redimensionnement en haut à droite par défaut de QtShellChrome. Si elle est définie, une DragHandler sera installée sur la poignée de redimensionnement qui redimensionne la fenêtre en déplaçant ses bords supérieur et droit dans des proportions égales.

La poignée se cache et s'affiche automatiquement, en fonction des drapeaux de fenêtre et de l'état plein écran de la fenêtre.

QtShellChrome {
   Rectangle {
       id: trrh
       anchors.top: parent.top
       anchors.right: parent.right
       height: 5
       width: 5
       color: "white"
   }
   topRightResizeHandle: trrh
}

windowFlags : int [read-only]

Cette propriété contient les drapeaux de fenêtre de QtShellChrome. Ils correspondront à la propriété windowFlags de la QtShellSurface associée, sauf si celle-ci est égale à Qt.Window. Dans ce cas, un ensemble de drapeaux de fenêtre par défaut sera utilisé à la place. Les drapeaux de fenêtre par défaut sont Qt.Window, Qt.WindowMaximizeButtonHint, Qt.WindowMinimizeButtonHint et Qt.WindowCloseButtonHint.

windowState : int [read-only]

Cette propriété contient l'état de la fenêtre de la surface de la coquille. Elle est mise à jour immédiatement lorsque l'état de la fenêtre est demandé du côté du compositeur, avant que le client n'en ait accusé réception. Par conséquent, elle peut brièvement différer de la propriété windowState de la surface de la coquille, qui sera mise à jour lorsque le client aura accusé réception de la demande.

Documentation de la méthode

void activate()

Activez manuellement cette fenêtre. Cela aura également pour effet de relever la fenêtre.

Voir aussi raise().

void deactivate()

Désactive manuellement cette fenêtre. Si la fenêtre était active, la fenêtre suivante de la pile sera activée.

void lower()

Abaisser cette fenêtre de manière à ce qu'elle s'empile sous d'autres fenêtres (sauf si les drapeaux de fenêtre des autres fenêtres l'interdisent).

void raise()

Relever cette fenêtre, de manière à ce qu'elle s'empile sur d'autres fenêtres (sauf si les drapeaux des autres fenêtres l'interdisent).

void toggleFullScreen()

Bascule entre l'état plein écran et l'état normal de la fenêtre. Cette méthode efface également les états de fenêtre minimisée ou maximisée si l'un ou l'autre est défini.

void toggleMaximized()

Bascule entre l'état maximisé et l'état normal. Cette méthode efface également l'état minimisé de la fenêtre s'il est activé.

void toggleMinimized()

Bascule entre l'état minimisé et l'état normal. Cette méthode efface également l'état de la fenêtre maximisée s'il est défini.