ControlStyle QML Type

Legt den Stil für ein Steuerelement im Zustand „ normal “ fest. Mehr...

Dieser Typ befindet sich in der Technologievorschau und kann sich noch ändern.

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• variations : list<StyleVariation>

Ausführliche Beschreibung

Ein „ControlStyle“ beschreibt, wie ein „ Control “ gestaltet werden soll. Seine API entspricht weitgehend der eines „ Qt Quick “-Steuerelements: Er bietet gruppierte Eigenschaften für Delegaten wie „ background “, „ indicator “, „ handle “ und „ text “ sowie Layout-Eigenschaften wie „ padding “ und „ spacing “. Wenn Sie mit der API eines „ Control “ in „ Qt Quick Controls “ vertraut sind, sollte Ihnen die „ControlStyle“-API leicht verständlich sein.

ControlStyle erbt von „ ControlStateStyle “, da es den Normalzustand darstellt: Eigenschaften, die direkt an einem ControlStyle festgelegt werden, beschreiben, wie das Steuerelement aussieht, wenn kein anderer Zustand aktiv ist. Zustandsspezifische Überschreibungen werden über verschachtelte Zustände festgelegt, wie beispielsweise „ hovered “, „ pressed “ und „ checked “.

Each stylable control In einem „ Style “, „ Theme “ oder „ StyleVariation “ ist ein „ControlStyle“ enthalten. Im folgenden Ausschnitt sind beispielsweise „ control “, „ button “ und „ radioButton “ allesamt „ControlStyles“:

Style {
    control {
        padding: 6
        text {
            color: "white"
        }
        background {
            radius: 4
            border.color: "gray"
        }
        indicator {
            width: 20
            height: 20
            border.width: 1
        }
        handle {
            width: 20
            height: 20
            radius: 10
        }
    }

    button {
        background {
            width: 120
            shadow.opacity: 0.6
            shadow.verticalOffset: 2
            shadow.horizontalOffset: 2
            shadow.color: "gray"
            color: "lightsteelblue"
            gradient: Gradient {
                GradientStop { position: 0.0; color: Qt.alpha("black", 0.0)}
                GradientStop { position: 1.0; color: Qt.alpha("black", 0.2)}
            }
        }
        hovered {
            background.color: "lightslategrey"
        }
        pressed {
            background.scale: 0.95
        }
    }

    radioButton {
    }

    checkBox {
    }

    slider {
    }

    // etc...
}

Siehe auch All stylable controls, Style, Theme, StyleVariation, ControlStateStyle und DelegateStyle.

Dokumentation zu Eigenschaften

variations : list<StyleVariation>

Eine Liste der „ type variations “ für diesen Steuerelementtyp.

Eine Typvariante bietet alternative Gestaltungsmöglichkeiten für Steuerelemente, die Kinder (oder Nachkommen) dieses Steuerelementtyps sind. Sie können damit beispielsweise alle „ buttons “ innerhalb eines „ frame “ anders gestalten als Schaltflächen an anderen Stellen:

Style {
    frame {
        variations: StyleVariation {
            button {
                text.color: "ghostwhite"
                background.border.width: 0
                background.color: "slategrey"
            }
        }
    }

    groupBox {
        // groupBox falls back to frame. Therefore, if the varations set on a
        // frame is not wanted on a groupBox, just override it and set it back to [].
        variations: []
    }
}

Im Gegensatz zu Instanzvariationen – die über die angehängte Eigenschaft „ StyleVariation::variations “ von der Anwendung auf bestimmte Steuerelementinstanzen angewendet werden – werden Typvariationen auf alle Instanzen eines Steuerelementtyps aus dem „ Style “ angewendet, ohne dass die Anwendung dies aktivieren muss.

Siehe auch „ StyleVariation “.