StyleReader QML Type

Liest Eigenschaften aus dem aktiven Stil für ein bestimmtes Steuerelement. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• checked : bool
• controlType : enumeration
• enabled : bool
• focused : bool
• font : font
• global : ControlStyleProperties
• highlighted : bool
• hovered : bool
• palette : palette
• pressed : bool
• vertical : bool

Detaillierte Beschreibung

StyleReader ist die Brücke zwischen einem Steuerelement in Qt Quick Controls und active style. Es stellt alle Stileigenschaften - backgrounds, indicators, handles, text, padding und mehr - zur Verfügung, an die ein Steuerelement und seine Delegierten binden sollten. Alle eingebauten StyleKit Steuerelemente verwenden intern einen StyleReader für diesen Zweck.

Die Zustandseigenschaften - hovered, pressed, focused, checked, highlighted, usw. - teilen StyleReader mit, in welchem Zustand sich das Steuerelement befindet. Er verwendet diese, um die richtigen Eigenschaftswerte aus Style aufzulösen und zu lesen, wobei Themes, StyleVariations, fallback types und die Eigenschaftsweitergabe berücksichtigt werden.

Bei der Implementierung eines CustomControl können Sie denselben Ansatz wie bei den eingebauten Steuerelementen verfolgen:

// Main.qml

component CustomButton : Rectangle {
    StyleReader {
        id: styleReader
        controlType: StyleReader.Button
        hovered: hoverHandler.hovered
        pressed: tapHandler.pressed
        palette: app.palette
    }

    implicitWidth: styleReader.background.implicitWidth
    implicitHeight: styleReader.background.implicitHeight
    color: styleReader.background.color
    radius: styleReader.background.radius

    HoverHandler { id: hoverHandler }
    TapHandler { id: tapHandler }

    Text {
        font: styleReader.font
        anchors.centerIn: parent
        text: "ok"
    }
}

Siehe auch CustomControl, Style, und StyleVariation.controlType.

Dokumentation der Eigenschaften

checked : bool

Ob das Steuerelement überprüft wird.

Binden Sie dies an die Eigenschaft checked des Steuerelements.

Der Standardwert ist false.

Siehe auch ControlStateStyle.checked.

controlType : enumeration

Gibt an, von welchem Kontrolltyp in Style dieser Leser Eigenschaften liest. Dies kann entweder auf einen der nachstehenden vordefinierten Werte oder auf eine in Style definierte custom control type gesetzt werden.

Siehe auch StyleVariation.controlType.

enabled : bool

Ob das Steuerelement aktiviert ist.

Binden Sie dies an die Eigenschaft enabled des Steuerelements.

Der Standardwert ist true.

Siehe auch ControlStyleState.disabled.

focused : bool

Ob das Steuerelement den aktiven Fokus hat.

Binden Sie dies an die Eigenschaft activeFocus des Steuerelements.

Der Standardwert ist false.

Siehe auch ControlStateStyle.focused.

font : font [read-only]

Die effektive Schriftart für diesen Steuerelementtyp, wie in style definiert. Dabei werden auch alle Schriftartüberschreibungen berücksichtigt, die in den text Eigenschaften des Stils festgelegt sind.

Binden Sie die Eigenschaft font des Steuerelements an diese Eigenschaft.

global : ControlStyleProperties [read-only]

Ermöglicht den direkten Zugriff auf die Stileigenschaften unter Umgehung aller laufenden transition.

Während ein Zustandsübergang im Gange ist, können Stileigenschaften, die von StyleReader gelesen werden, interpolierte Werte zurückgeben. Durch das Voranstellen von global an den Eigenschaftspfad umgehen Sie den Übergang und erhalten sofort die Werte des Endzustands.

Wenn Sie beispielsweise von hovered zu pressed wechseln, kann background.color einen interpolierten Wert zwischen color im Zustand hovered und der Farbe im Zustand pressed zurückgeben. global.background.color Im Gegensatz dazu gibt direkt die Farbe im gedrückten Zustand zurück.

Siehe auch transitionsEnabled.

highlighted : bool

Ob das Steuerelement hervorgehoben ist.

Binden Sie dies an die Eigenschaft highlighted des Steuerelements.

Der Standardwert ist false.

Siehe auch ControlStateStyle.highlighted.

hovered : bool

Ob das Steuerelement im Schwebezustand ist.

Binden Sie dies an die Eigenschaft hovered des Steuerelements.

Der Standardwert ist false.

Siehe auch ControlStateStyle.hovered.

palette : palette

Die Palette des Steuerelements. StyleKit verwendet dies, um Farbeigenschaften aufzulösen, die die palette in der Style binden.

Binden Sie dies an die palette Eigenschaft des Steuerelements.

Siehe auch Style.palette.

pressed : bool

Ob das Steuerelement gedrückt ist.

Binden Sie dies an die Eigenschaft pressed des Steuerelements.

Der Standardwert ist false.

Siehe auch ControlStateStyle.pressed.

vertical : bool

Ob das Steuerelement vertikal ausgerichtet ist.

Binden Sie dies an die orientation des Steuerelements.

Der Standardwert ist false.

Siehe auch ControlStateStyle.vertical.