StyleReader QML Type

Liest die Eigenschaften des aktiven Stils für ein bestimmtes Steuerelement aus. Mehr...

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

• 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

Ausführliche Beschreibung

StyleReader ist die Brücke zwischen einem Steuerelement in Qt Quick Controls und dem „ active style “. Er stellt alle Stil-Eigenschaften bereit – „ backgrounds “, „ indicators “, „ handles “, „ text “, „ padding “ und weitere –, an die ein Steuerelement und seine Delegaten gebunden werden sollten. Alle integrierten „ StyleKit “-Steuerelemente verwenden intern zu diesem Zweck einen „StyleReader“.

Die Zustands-Eigenschaften – hovered, pressed, focused, checked, highlighted usw. – teilen dem StyleReader mit, in welchem Zustand sich das Steuerelement befindet. Er nutzt diese, um die korrekten Eigenschaftswerte aus dem Style aufzulösen und auszulesen, wobei er Themes, StyleVariations, fallback types sowie die Eigenschaftsweitergabe berücksichtigt.

Bei der Implementierung eines „ CustomControl “ können Sie denselben Ansatz wie bei den integrierten 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.width
    implicitHeight: styleReader.background.height
    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, StyleVariation.controlType und „StyleKit Property Resolution“.

Dokumentation zu Eigenschaften

checked : bool

Ob das Steuerelement aktiviert ist.

Binden Sie dies an die Eigenschaft „ checked “ des Steuerelements.

Der Standardwert ist „ false “.

Siehe auch „ ControlStateStyle.checked “.

controlType : enumeration

Gibt an, von welchem Steuerelementtyp in der „ Style “ dieser Reader Eigenschaften liest. Hierfür kann entweder einer der unten aufgeführten vordefinierten Werte oder ein im „ Style “ definierter „ custom control type “ festgelegt 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 „ ControlStateStyle.disabled “.

focused : bool

Gibt an, ob das Steuerelement den Fokus hat.

Binden Sie dies an die Eigenschaft „ activeFocus “ des Steuerelements.

Der Standardwert ist „ false “.

Siehe auch „ ControlStateStyle.focused “.

font : font [read-only]

Die für diesen Steuerelementtyp gültige Schriftart, wie durch die Eigenschaft „ style “ definiert. Dabei werden auch etwaige Schriftart-Überschreibungen berücksichtigt, die in den Eigenschaften „ text “ des Stils festgelegt wurden.

Binden Sie die Eigenschaft „ font “ des Steuerelements an diese Eigenschaft.

global : ControlStyleProperties [read-only]

Bietet direkten Zugriff auf die Stileigenschaften und umgeht dabei jegliche laufenden transition.

Während ein Zustandsübergang läuft, können die aus einem StyleReader gelesenen Stileigenschaften interpolierte Werte zurückgeben. Indem Sie dem Eigenschaftspfad global voranstellen, umgehen Sie den Übergang und erhalten sofort die Werte des Endzustands.

Beispielsweise kann beim Übergang von „ hovered “ zu „ pressed “ die Eigenschaft „ background.color “ einen interpolierten Wert zwischen dem „ color “ im Zustand „ hovered “ und der Farbe im Zustand „ pressed “ zurückgeben. „ global.background.color “ hingegen gibt direkt die Farbe im „pressed“-Zustand zurück.

Siehe auch transitionsEnabled.

highlighted : bool

Ob das Steuerelement markiert ist.

Binden Sie dies an die Eigenschaft „ highlighted “ des Steuerelements.

Der Standardwert ist ` false`.

Siehe auch „ ControlStateStyle.highlighted “.

hovered : bool

Ob der Mauszeiger über dem Steuerelement schwebt.

Binden Sie dies an die Eigenschaft „ hovered “ des Steuerelements.

Der Standardwert ist „ false “.

Siehe auch „ ControlStateStyle.hovered “.

palette : palette

Die Farbpalette des Steuerelements. StyleKit verwendet diese, um Farbeigenschaften aufzulösen, die an die Eigenschaft „ palette “ im „ Style “ gebunden sind.

Binden Sie dies an die Eigenschaft „ palette “ des Steuerelements.

Siehe auch „ Style.palette “.

pressed : bool

Ob die Schaltfläche 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 Eigenschaft „ orientation “ des Steuerelements.

Der Standardwert ist „ false “.

Siehe auch „ ControlStateStyle.vertical “.