ControlStyleProperties QML Type
Definiert die anpassbaren Eigenschaften eines Steuerelements. Mehr...
| Import Statement: | import Qt.labs.StyleKit |
| Inherited By: | ControlStateStyle, ControlStyle, CustomControl, and StyleReader |
| Status: | Technology preview |
Dieser Typ befindet sich in der Technologievorschau und kann sich noch ändern.
Eigenschaften
- background : DelegateStyle
- bottomPadding : real
- handle : HandleStyle
- indicator : IndicatorStyle
- leftPadding : real
- padding : real
- rightPadding : real
- spacing : real
- text : TextStyle
- topPadding : real
- transition : Transition
Ausführliche Beschreibung
„ControlStyleProperties“ definiert die anpassbaren Eigenschaften eines Steuerelements: die visuellen Bausteine „ background “, „ indicator “, „ handle “ und „ text “ sowie Layout-Eigenschaften wie „ padding “, „ spacing “ und „ transition “.
Der Zugriff auf die Stileigenschaften erfolgt über vererbte Typen wie ControlStyle und StyleReader.
Hinweis: Es kann nicht garantiert werden, dass die Typen in Qt.labs-Modulen in zukünftigen Versionen kompatibel bleiben.
Siehe auch ControlStyle, StyleReader, ControlStateStyle und DelegateStyle.
Dokumentation zu Eigenschaften
background : DelegateStyle
Gruppierte Eigenschaft zur Gestaltung des Hintergrunds eines Steuerelements.
Der Hintergrund-Delegat ist in der Regel das visuelle Hauptrechteck hinter dem Steuerelement. Verwenden Sie ihn, um folgende Eigenschaften festzulegen: „ colors “, „ borders “, „ radii “, „ shadows “, „ gradients “ und „ images “.
Hinweis: Die Standardeinstellung „ fallback style “ legt für Steuerelemente, die normalerweise keinen Hintergrund zeichnen sollten – wie beispielsweise CheckBox, RadioButton und Slider – den Wert „ background.visible “ auf „ false “ fest. Um deren Hintergrund anzuzeigen, setzen Sie „ background.visible “ explizit auf „ true “.
bottomPadding : real
Die „ bottom padding “ des Steuerelements. Falls nicht festgelegt, wird auf „ padding “ zurückgegriffen.
Siehe auch padding, topPadding, leftPadding und rightPadding.
handle : HandleStyle
Gruppierte Eigenschaft zur Gestaltung des Handles eines Steuerelements.
Der Griff wird von Steuerelementen wie Switch, Slider und RangeSlider verwendet. Bei einem RangeSlider können die beiden Griffe individuell über handle.first und handle.second gestaltet werden.
Siehe auch HandleStyle und DelegateStyle.
indicator : IndicatorStyle
Gruppierte Eigenschaft zur Gestaltung der Anzeige eines Steuerelements. Bei einem „ checkBox “ ist die Anzeige der Rahmen, und der „ foreground “ ist das Häkchen. Bei einem „ slider “ ist die Anzeige die Vertiefung, und der „ “ ist die Füllung.
Siehe auch „ DelegateStyle “.
leftPadding : real
Die „ left padding “ des Steuerelements. Falls nicht festgelegt, wird standardmäßig „ padding “ verwendet.
Siehe auch padding, rightPadding, topPadding und bottomPadding.
padding : real
Der einheitliche Abstand zwischen den control's content area and the bounds of the control. Durch diese Einstellung wird ein Standardwert für leftPadding, rightPadding, topPadding und bottomPadding festgelegt. Jede Seite kann individuell überschrieben werden.
Siehe auch leftPadding, rightPadding, topPadding und bottomPadding.
rightPadding : real
Die „ right padding “ des Steuerelements. Falls nicht festgelegt, wird auf „ padding “ zurückgegriffen.
Siehe auch padding, leftPadding, topPadding und bottomPadding.
spacing : real
Der Abstand zwischen visuellen Elementen innerhalb des Steuerelements, beispielsweise zwischen einer Anzeige und einer Beschriftung.
text : TextStyle
Gruppierte Eigenschaft zur Gestaltung der Textbeschriftung eines Steuerelements.
topPadding : real
Die „ top padding “ des Steuerelements. Falls nicht festgelegt, wird auf „ padding “ zurückgegriffen.
Siehe auch padding, bottomPadding, leftPadding und rightPadding.
transition : Transition
Eine „ Transition “ wird verwendet, um Stileigenschaften zu animieren, wenn das Steuerelement in einen neuen Zustand wechselt, z. B. „ hovered “ oder „ pressed “. Bei der Einstellung „ null “ (Standard) werden Eigenschaftsänderungen sofort und ohne Animation übernommen.
button {
background.color: "mistyrose"
hovered.background.color: "plum"
transition: Transition {
ColorAnimation {
properties: "background.color, background.shadow.color, handle.color"
easing.type: Easing.OutQuad
duration: 500
}
NumberAnimation {
properties: "background.leftRadius, background.rightRadius"
easing.type: Easing.OutQuad
duration: 500
}
}
// I only want a fade-out effect (not fade-in). So while the button
// is hovered, remove the transition, so that it only applies in the
// normal state. In other words, it's the state being entered that
// determines the transition, not the state that is left.
hovered.transition: null
}Um zu vermeiden, dass für jeden Delegaten dieselben Ziel-Eigenschaften wiederholt werden müssen, stellt StyleKit zur Vereinfachung „ StyleAnimation “ zur Verfügung, das anstelle der Standardanimationen oder in Kombination mit diesen verwendet werden kann :
comboBox {
background.color: "mistyrose"
hovered.background.color: "plum"
transition: Transition {
StyleAnimation {
animateColors: true
animateBackgroundRadii: true
animateIndicatorRadii: true
animateBackgroundShadow: true
easing.type: Easing.OutQuad
duration: 500
}
}
}Hinweis: Bei Farbeigenschaften, die an einem Übergang beteiligt sind, sollten Sie „ Qt.alpha “ gegenüber „ "transparent" “ bevorzugen (z. B. „ menuBarItem.background.color: Qt.alpha(palette.accent, 0) “). „ "transparent" “ entspricht „ Qt.rgba(0, 0, 0, 0) “, was dazu führen kann, dass interpolierte Farben während des Übergangs in Richtung Schwarz verschoben werden.
© 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.