Auf dieser Seite

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

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.