ControlStyleProperties QML Type
Definiert die stilisierbaren Eigenschaften für ein Steuerelement. Mehr...
| Import Statement: | import Qt.labs.StyleKit |
| Inherited By: | ControlStateStyle, ControlStyle, CustomControl, and StyleReader |
Eigenschaften
- background : DelegateStyle
- bottomPadding : real
- handle : HandleStyle
- indicator : IndicatorStyle
- leftPadding : real
- padding : real
- rightPadding : real
- spacing : real
- text : TextStyle
- topPadding : real
- transition : Transition
Detaillierte Beschreibung
ControlStyleProperties definiert die stilisierbaren Eigenschaften für ein Steuerelement: die visuellen Bausteine background, indicator, handle und text, sowie Layout-Eigenschaften wie padding, spacing und transition.
Der Zugriff auf die Stileigenschaften erfolgt über geerbte Typen wie ControlStyle und StyleReader.
Hinweis: Es ist nicht garantiert, dass Typen in Qt.labs-Modulen in zukünftigen Versionen kompatibel bleiben.
Siehe auch ControlStyle, StyleReader, ControlStateStyle, und DelegateStyle.
Dokumentation der Eigenschaften
background : DelegateStyle
Gruppeneigenschaft für die Gestaltung des Hintergrunds eines Steuerelements.
Der Hintergrunddelegierte ist normalerweise das visuelle Hauptrechteck hinter dem Steuerelement. Verwenden Sie es, um colors, borders, radii, shadows, gradients und images einzustellen.
Hinweis: Die Standardeinstellung fallback style setzt background.visible auf false für Steuerelemente, die normalerweise keinen Hintergrund zeichnen sollten, wie CheckBox, RadioButton und Slider. Um deren Hintergrund zu zeigen, setzen Sie background.visible explizit auf true.
bottomPadding : real
Die bottom padding des Steuerelements. Wenn es nicht gesetzt ist, fällt es auf padding zurück.
Siehe auch padding, topPadding, leftPadding, und rightPadding.
handle : HandleStyle
Gruppierte Eigenschaft für das Styling des Handles eines Steuerelements.
Das Handle wird von Steuerelementen wie Switch, Slider und RangeSlider verwendet. Bei RangeSlider können die beiden Griffe über handle.first und handle.second individuell gestaltet werden.
Siehe auch HandleStyle und DelegateStyle.
indicator : IndicatorStyle
Gruppeneigenschaft für die Gestaltung des Indikators eines Steuerelements. Bei einem checkBox ist der Indikator der Rahmen, und sein foreground ist das Häkchen. Bei einem slider ist der Indikator die Rille und der Vordergrund die Füllung.
Siehe auch DelegateStyle.
leftPadding : real
Die left padding des Steuerelements. Wenn es nicht gesetzt ist, fällt es auf padding zurück.
Siehe auch padding, rightPadding, topPadding, und bottomPadding.
padding : real
Der einheitliche Abstand zwischen den control's content area and the bounds of the control. Diese Einstellung bietet einen Standardwert für leftPadding, rightPadding, topPadding und bottomPadding. Jede Seite kann einzeln außer Kraft gesetzt werden.
Siehe auch leftPadding, rightPadding, topPadding, und bottomPadding.
rightPadding : real
Die right padding des Steuerelements. Wenn es nicht gesetzt ist, fällt es auf padding zurück.
Siehe auch padding, leftPadding, topPadding, und bottomPadding.
spacing : real
Der Abstand zwischen visuellen Elementen innerhalb des Steuerelements, z. B. zwischen einem Indikator und einem Etikett.
text : TextStyle
Gruppierte Eigenschaft für die Gestaltung der Textbeschriftung eines Steuerelements.
topPadding : real
Die top padding des Steuerelements. Wenn es nicht gesetzt ist, fällt es auf padding zurück.
Siehe auch padding, bottomPadding, leftPadding, und rightPadding.
transition : Transition
Transition wird verwendet, um Stileigenschaften zu animieren, wenn das Steuerelement in einen neuen Zustand übergeht, z. B. wenn es in der Schwebe gehalten oder gedrückt wird. 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 dieselben Zieleigenschaften für jeden Delegaten wiederholt werden, bietet StyleKit der Einfachheit halber StyleAnimation, das anstelle von oder in Kombination mit den Standardanimationen 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 } } }
Beachten Sie auch, dass ColorAnimation eine besondere Funktion hat, die alle Farbeigenschaften animiert, die sich während einer Zustandsänderung geändert haben, wenn property und properties nicht gesetzt sind.
© 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.