QtShellChrome QML Type

Bietet Standardfunktionen eines Fenstermanagers zur Verwendung mit der Erweiterung „ qt-shell “. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• 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

Methoden

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

Ausführliche Beschreibung

QtShellChrome ist ein Komforttyp, der verwendet werden kann, um bei der Interaktion mit Clients über das Shell-Erweiterungsprotokoll „ qt-shell “ Funktionen eines Fenstermanagers bereitzustellen.

Bei einem „ ShellSurfaceItem “ mit einem zugehörigen „ QtShellSurface “ passt das Element seine Größe automatisch an die Oberfläche an. Außerdem sorgt es für die automatische Handhabung von:

• Fensterzustände wie maximiert, minimiert und Vollbild.
• Fensteraktivierung.
• Änderung der Fenstergröße mithilfe von Größenänderungsgriffen (sofern die entsprechenden Eigenschaften festgelegt sind).
• Neupositionierung des Fensters über die Titelleiste (sofern die Eigenschaft ` titleBar ` gesetzt ist).

„QtShellChrome“ ist für die Verwendung zusammen mit „ QtShell “ und „ QtShellSurface “ vorgesehen.

Siehe auch QtShell-Compositor.

Dokumentation zu den Eigenschaften

bottomLeftResizeHandle : Item

Diese Eigenschaft enthält den standardmäßigen Griff zur Größenänderung unten links des Fensters „ QtShellChrome “. Ist diese Eigenschaft gesetzt, wird am Griff zur Größenänderung ein „ DragHandler “ angebracht, der die Größe des Fensters anpasst, indem er dessen untere und linke Kante um denselben Betrag verschiebt.

Der Griff wird je nach den Fensterflags und dem Vollbildstatus des Fensters automatisch ein- und ausgeblendet.

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

bottomResizeHandle : Item

Diese Eigenschaft enthält den standardmäßigen unteren Größenänderungsgriff des „ QtShellChrome “. Wenn diese Eigenschaft gesetzt ist, wird am Größenänderungsgriff ein „ DragHandler “ installiert, der die Größe des Fensters durch Verschieben seiner unteren Kante anpasst.

Der Griff wird je nach den Fensterflags und dem Vollbildstatus des Fensters automatisch ein- und ausgeblendet.

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

bottomRightResizeHandle : Item

Diese Eigenschaft enthält den standardmäßigen Größenänderungsgriff unten rechts des „ QtShellChrome “. Wenn diese Eigenschaft gesetzt ist, wird am Größenänderungsgriff ein „ DragHandler “ angebracht, der die Größe des Fensters so anpasst, dass seine untere und rechte Kante um denselben Betrag verschoben werden.

Der Griff wird je nach den Fensterflags und dem Vollbildstatus des Fensters automatisch ein- und ausgeblendet.

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

frameMarginBottom : int

Legt die Größe des unteren Randes des „ QtShellChrome “ fest, der für Fensterdekorationen reserviert ist. Standardmäßig entspricht dieser Wert der Höhe des „ bottomResizeHandle “, sofern dieser festgelegt ist. Andernfalls beträgt er 0.

frameMarginLeft : int

Legt die Größe des linken Randes des „ QtShellChrome “ fest, der für Fensterdekorationen reserviert ist. Standardmäßig entspricht dieser Wert der Breite des „ leftResizeHandle “, sofern dieser festgelegt ist. Andernfalls beträgt er 0.

frameMarginRight : int

Legt die Größe des rechten Randes des „ QtShellChrome “ fest, der für Fensterdekorationen reserviert ist. Standardmäßig entspricht dieser Wert der Breite des „ rightResizeHandle “, sofern dieser festgelegt ist. Andernfalls beträgt er 0.

frameMarginTop : int

Legt die Größe des oberen Randes des „ QtShellChrome “ fest, der für Fensterdekorationen reserviert ist. Standardmäßig entspricht dieser Wert der Summe der Höhen von „ leftResizeHandle “ und „ titleBar “, sofern diese festgelegt sind. Andernfalls beträgt er 0.

hasDecorations : bool [read-only]

Diese Eigenschaft ist wahr, wenn die Dekorationen des „ QtShellChrome “ basierend auf dessen Fensterzustand und Fensterflags sichtbar sein sollen.

leftResizeHandle : Item

Diese Eigenschaft enthält den standardmäßigen linken Größenänderungsgriff des „ QtShellChrome “. Wenn diese Eigenschaft gesetzt ist, wird am Größenänderungsgriff ein „ DragHandler “ installiert, der die Größe des Fensters durch Verschieben seiner linken Kante anpasst.

Der Griff wird je nach den Fensterflags und dem Vollbildstatus des Fensters automatisch ein- und ausgeblendet.

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

maximizedRect : rect

Diese Eigenschaft gibt die Fläche des „ WaylandOutput “ an, die das Fenster ausfüllen kann, wenn es maximiert ist. Standardmäßig füllt das Fenster bei Maximierung die gesamte Geometrie des „ WaylandOutput “ aus. Eine Änderung dieser Einstellung kann beispielsweise dann sinnvoll sein, wenn der Compositor andere System-UI-Elemente enthält, die nicht von maximierten Anwendungen verdeckt werden sollen, wie z. B. die Taskleiste.

rightResizeHandle : Item

Diese Eigenschaft enthält den standardmäßigen rechten Größenänderungsgriff des „ QtShellChrome “. Wenn diese Eigenschaft gesetzt ist, wird am Größenänderungsgriff ein „ DragHandler “ installiert, der die Größe des Fensters durch Verschieben seines rechten Randes anpasst.

Der Griff wird je nach den Fensterflags und dem Vollbildstatus des Fensters automatisch ein- und ausgeblendet.

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

shellSurfaceItem : ShellSurfaceItem

Diese Eigenschaft enthält das Shell-Oberflächenelement, das diesem QtShellChrome zugeordnet ist. Dieses verwaltet wiederum das shellSurface dieses Elements. Es wird erwartet, dass das shellSurface des Elements vom Typ QtShellSurface ist.

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

titleBar : Item

Diese Eigenschaft enthält das Standardelement der Titelleiste des „ QtShellChrome “. Ist diese Eigenschaft gesetzt, wird ein „ DragHandler “ in der Titelleiste eingebaut, mit dem das Fenster bei Benutzerinteraktion verschoben werden kann. Zudem wird das Fenster automatisch aktiviert, wenn auf die Titelleiste geklickt wird.

Die Titelleiste wird je nach den Fensterflags und dem Vollbildstatus des Fensters automatisch ein- und ausgeblendet.

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

Diese Eigenschaft enthält den standardmäßigen Größenänderungsgriff oben links des „ QtShellChrome “. Wenn diese Eigenschaft gesetzt ist, wird am Größenänderungsgriff ein „ DragHandler “ installiert, der die Größe des Fensters so anpasst, dass seine obere und linke Kante um denselben Betrag verschoben werden.

Der Griff wird je nach den Fensterflags und dem Vollbildstatus des Fensters automatisch ein- und ausgeblendet.

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

topResizeHandle : Item

Diese Eigenschaft enthält den standardmäßigen oberen Größenänderungsgriff des „ QtShellChrome “. Wenn diese Eigenschaft gesetzt ist, wird am Größenänderungsgriff ein „ DragHandler “ installiert, der die Größe des Fensters durch Verschieben seiner Oberkante anpasst.

Der Griff wird je nach den Fensterflags und dem Vollbildstatus des Fensters automatisch ein- und ausgeblendet.

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

topRightResizeHandle : Item

Diese Eigenschaft enthält den standardmäßigen Größenänderungsgriff oben rechts des „ QtShellChrome “. Wenn diese Eigenschaft gesetzt ist, wird am Größenänderungsgriff ein „ DragHandler “ installiert, der die Größe des Fensters so ändert, dass seine obere und rechte Kante um denselben Betrag verschoben werden.

Der Griff wird je nach den Fenster-Flags und dem Vollbildstatus des Fensters automatisch ein- und ausgeblendet.

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

windowFlags : int [read-only]

Diese Eigenschaft enthält die Fensterflags von ` QtShellChrome`. Sie stimmen mit der Eigenschaft ` windowFlags ` des zugehörigen ` QtShellSurface` überein, es sei denn, diese ist gleich `Qt.Window`. In diesem Fall wird stattdessen ein Satz von Standard-Fensterflags verwendet. Die Standard-Fensterflags sind Qt.Window, Qt.WindowMaximizeButtonHint, Qt.WindowMinimizeButtonHint und Qt.WindowCloseButtonHint.

windowState : int [read-only]

Diese Eigenschaft enthält den Fensterzustand der Shell-Oberfläche. Sie wird sofort aktualisiert, sobald der Fensterzustand auf Compositor-Seite abgefragt wird, noch bevor der Client dies bestätigt hat. Daher kann sie für kurze Zeit von der Eigenschaft „ windowState “ der Shell-Oberfläche abweichen, die erst aktualisiert wird, wenn der Client die Anfrage bestätigt hat.

Methodendokumentation

void activate()

Aktivieren Sie dieses Fenster manuell. Dadurch wird das Fenster auch in den Vordergrund geholt.

Siehe auch „ raise“ ().

void deactivate()

Deaktiviert dieses Fenster manuell. War das Fenster aktiv, wird stattdessen das nächste Fenster in der Stapelreihenfolge aktiviert.

void lower()

Verringere die Sichtbarkeit dieses Fensters, sodass es unter anderen Fenstern angezeigt wird (es sei denn, die Fenstereigenschaften des anderen Fensters lassen dies nicht zu).

void raise()

Dieses Fenster so anzeigen, dass es über anderen Fenstern liegt (es sei denn, die Einstellungen der anderen Fenster verhindern dies).

void toggleFullScreen()

Schaltet zwischen Vollbild- und normalem Fenstermodus um. Diese Methode hebt zudem den minimierten oder maximierten Fenstermodus auf, falls einer davon aktiviert ist.

void toggleMaximized()

Wechselt zwischen dem maximierten und dem normalen Zustand. Diese Methode hebt zudem den minimierten Fensterzustand auf, falls dieser gesetzt ist.

void toggleMinimized()

Wechselt zwischen dem minimierten und dem normalen Zustand. Diese Methode hebt zudem den Zustand „maximiertes Fenster“ auf, falls dieser gesetzt ist.