ControlStyle QML Type

Definiert den Stil für ein Steuerelement im Zustand normal. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• variations : list<StyleVariation>

Detaillierte Beschreibung

Ein ControlStyle beschreibt, wie ein Control gestylt werden soll. Seine API spiegelt weitgehend die eines Qt Quick Controls wider: Es bietet gruppierte Eigenschaften für Delegierte wie background, indicator, handle und text, zusammen mit Layout-Eigenschaften wie padding und spacing. Wenn Sie mit der API eines Control in Qt Quick Controls vertraut sind, sollten Sie die ControlStyle-API leicht nachvollziehen können.

ControlStyle erbt ControlStateStyle, weil es den Normalzustand darstellt: Eigenschaften, die direkt auf ein ControlStyle gesetzt werden, beschreiben, wie das Steuerelement aussieht, wenn kein anderer Zustand aktiv ist. Zustandsspezifische Überschreibungen werden durch verschachtelte Zustände festgelegt, wie hovered pressed und checked.

Each stylable control in einem Style, Theme, oder StyleVariation ist ein ControlStyle. Im folgenden Ausschnitt sind zum Beispiel control, button und radioButton alle ControlStyles:

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

    button {
        background {
            implicitWidth: 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 der Eigenschaften

variations : list<StyleVariation>

Eine Liste von type variations für diesen Kontrolltyp.

Eine Typvariation bietet ein alternatives Styling für Steuerelemente, die Kinder (oder Nachkommen) dieses Steuerelementtyps sind. Beispielsweise können Sie damit alle buttons innerhalb eines frame anders gestalten als Schaltflächen an anderer Stelle:

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 auf bestimmte Steuerelementinstanzen von der Anwendung aus angewendet werden - werden Typvariationen auf alle Instanzen eines Steuerelementtyps von Style aus angewendet, ohne dass die Anwendung sich dafür entscheiden muss.

Siehe auch StyleVariation.