Auf dieser Seite

IndicatorStyle QML Type

Legt den Stil für die Anzeige eines Steuerelements fest. Mehr...

Import Statement: import Qt.labs.StyleKit
Inherits:

DelegateStyle

Status: Technology preview

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

Eigenschaften

Ausführliche Beschreibung

„IndicatorStyle“ erweitert „ DelegateStyle “ um Eigenschaften, die speziell für die Gestaltung eines Indikators gelten.

Der „IndicatorStyle“ selbst beschreibt den Hintergrund des Indikators, während der „ foreground “ den darin gezeichneten Inhalt beschreibt. Beispielsweise gestaltet „ checkBox.indicator “ den Rahmen des Kontrollkästchens und „ checkBox.indicator.foreground “ das Häkchen. Bei „ switchControl “, „ slider “ und „ progressBar “ gestaltet der „IndicatorStyle“ die Rille und der „ForegroundStyle“ die Füllung.

checkBox {
    background.visible: false
    text.alignment: Qt.AlignVCenter | Qt.AlignLeft
    indicator {
        color: "transparent"
        border.width: 1
        foreground {
            color: "transparent"
            image.source: "qrc:/qt-project.org/imports/QtQuick/Controls/Basic/images/check.png"
            // Hide the checkMark when the CheckBox is unchecked
            visible: false
        }
    }
    checked {
        // Show the checkMark when the CheckBox is checked
        indicator.foreground.visible: true
    }
}

Einige Steuerelemente verfügen über mehr als einen Indikator. Beispielsweise verfügt SpinBox sowohl über eine Schaltfläche zum Erhöhen als auch über eine zum Verringern. Diese können mithilfe der Unterindikatoren „ first “ und „ second “ sowie „ spinBox.indicator.first “ und „ spinBox.indicator.second “ unabhängig voneinander gestaltet werden. Bei SpinBox gestaltet „ indicator.first “ die Schaltfläche zum Erhöhen und „ indicator.second “ die Schaltfläche zum Verringern. Eigenschaften, die nicht für einen Unterindikator festgelegt sind, werden auf den Indikator selbst zurückgesetzt.

Hinweis: Die Eigenschaften „ up “ und „ down “ werden aus Gründen der Abwärtskompatibilität als Aliase für „ first “ und „ second “ beibehalten. Neuer Code sollte „ first “ und „ second “ verwenden, da diese Namen generisch sind und von Steuerelementen mit Unteranzeigen verwendet werden können, die keine Aufwärts-/Abwärts-Aktionen darstellen. Die Kompatibilitätsaliase werden möglicherweise in einer zukünftigen Version entfernt.

spinBox {
    text.alignment: Qt.AlignHCenter | Qt.AlignVCenter
    padding: 0
    indicator {
        fillHeight: true
        color: "navy"
        opacity: 0.1
        foreground {
            color: "transparent"
            margins: 10
            image.color: "navy"
            image.fillMode: Image.PreserveAspectFit
            image.source: "qrc:/qt-project.org/imports/QtQuick/Controls/Basic/images/arrow-indicator.png"
            width: 10
            height: 10
            alignment: Qt.AlignCenter
        }
        // up button
        first {
            alignment: Qt.AlignRight
            foreground.rotation: -90
        }
        // down button
        second {
            alignment: Qt.AlignLeft
            foreground.rotation: 90
        }
    }
}

Hinweis: Es kann nicht garantiert werden, dass Typen in Qt.labs-Modulen in zukünftigen Versionen kompatibel bleiben.

Siehe auch „ SubIndicatorStyle“ , „ DelegateStyle “, „ ControlStyle “, „ ControlStateStyle “ und die „FallbackStyle“-Referenz.

Dokumentation zu den Eigenschaften

first : SubIndicatorStyle

Gruppierte Eigenschaft zur Gestaltung des ersten Unterindikators von Steuerelementen, die mehrere Indikatoren anzeigen. Bei „ SpinBox “ wird damit die Schaltfläche „Erhöhen“ gestaltet. Nicht festgelegte Eigenschaften fallen auf den Indikator selbst zurück.

Hinweis: Die Eigenschaft „ up “ wird aus Gründen der Abwärtskompatibilität als Alias für „ first “ beibehalten. In neuem Code sollte „ first “ verwendet werden, da dieser Name generisch ist und von Steuerelementen mit Unteranzeigen verwendet werden kann, die keine „Hoch“-Aktionen darstellen. Der Kompatibilitätsalias wird möglicherweise in einer zukünftigen Version entfernt.

Siehe auch second.

foreground : DelegateStyle

Gruppierte Eigenschaft zur Gestaltung des Vordergrundelements dieses Indikators. Beispielsweise beschreibt „ checkBox.indicator “ den Rahmen des Kontrollkästchens, während „ checkBox.indicator.foreground “ das Häkchen bezeichnet.

Bei Steuerelementen wie slider, progressBar und switchControl stellt „ indicator.foreground “ die Fortschrittsanzeige oder die Füllung innerhalb der Rille dar, während „ indicator “ selbst die Rille darstellt.

second : SubIndicatorStyle

Gruppierte Eigenschaft zur Gestaltung der zweiten Unteranzeige beispielsweise eines „ SpinBox “. Nicht festgelegte Eigenschaften greifen auf die Anzeige selbst zurück.

Hinweis: Die Eigenschaft „ down “ wird aus Gründen der Abwärtskompatibilität als Alias für „ second “ beibehalten. Neuer Code sollte „ second “ verwenden, da dieser Name generisch ist und von Steuerelementen mit Unteranzeigen verwendet werden kann, die keine „Down“-Aktionen darstellen. Der Kompatibilitätsalias wird möglicherweise in einer zukünftigen Version entfernt.

Siehe auch first.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.