StyleKitDebug QML Type

Zeigt auf, wie Stileigenschaften für ein Steuerelement aufgelöst werden. Mehr...

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

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• control : Item
• filter : string

Ausführliche Beschreibung

StyleKitDebug ist ein diagnostisches In-App-Tool, das das Auslesen von Stileigenschaften in der Debug-Ausgabe protokolliert. Es ist hilfreich, um zu verstehen, warum ein Steuerelement ein bestimmtes Erscheinungsbild annimmt, insbesondere bei komplexen Stilen, die mehrere „ themes “ oder „ style variations “ beinhalten.

Der Zugriff erfolgt über ` StyleKit.debug`.

Um die Ablaufverfolgung zu starten, weisen Sie das Steuerelement, das Sie untersuchen möchten, der Eigenschaft „ control “ zu:

ApplicationWindow {
    id: app
    width: 1024
    height: 800
    visible: true

    StyleKit.debug.control: someButton
    StyleKit.debug.filter: "background.color"

    StyleKit.style: Style {
        button {
            background.color: "gray"
            hovered.background.color: "dimgray"
        }
        dark: Theme {
            button {
                background.color: "skyblue"
                hovered.background.color: "lightblue"
            }
        }
    }

    Column {
        anchors.fill: parent
        anchors.margins: 10
        spacing: 10

        Button {
            id: someButton
            text: "A Button"
        }
    }
}

Jede aufgelöste Eigenschaft wird in einer einzelnen Zeile ausgegeben, aus der hervorgeht, woher der Wert stammt und zu welchem Wert er aufgelöst wurde:

[read] StyleReader[Hovered].button.background.color -> Style.Theme(Dark).button[Hovered] = #add8e6

Der Begriff „ StyleReader “ in der Ausgabe bezieht sich auf die „ StyleReader “, die der „ Button “ intern zum Auslesen seiner Stileigenschaftswerte verwendet.

Das Verfolgen der Eigenschaftsauslesungen eines „ StyleReader “ kann zu einer großen Menge an Ausgabe führen. Verwenden Sie „ filter “, um die Ausgabe auf die gewünschten Eigenschaften zu beschränken.

Siehe auch „ StyleKit::debug “ und „StyleKit-Eigenschaftsauflösung“.

Eigenschaftsdokumentation

control : Item

Die ID des zu verfolgenden „ Control “ oder „ StyleReader “.

Wenn diese Option gesetzt ist, protokolliert StyleKit alle Lesezugriffe auf Stil-Eigenschaften für dieses Element in der Debug-Ausgabe. Setzen Sie den Wert auf „ null “, um die Protokollierung zu beenden.

Siehe auch filter.

filter : string

Ein regulärer Ausdruck zum Filtern der Debug-Ausgabe. Es werden nur Zeilen ausgegeben, die dem Muster entsprechen. Standardmäßig wird die gesamte Ausgabe angezeigt.

Beispiel, um nur die Hintergrundfarbe zu protokollieren:

StyleKit.debug.filter: "background.color"

Um alle Hintergrundfarben zu protokollieren, einschließlich Eigenschaften wie background.color, background.border.color, background.image.color und background.shadow.color, verwenden Sie einen regulären Ausdruck:

StyleKit.debug.filter: "background.*color"

Siehe auch control.