IndicatorStyle QML Type
Legt den Stil für die Anzeige eines Steuerelements fest. Mehr...
| Import Statement: | import Qt.labs.StyleKit |
| Inherits: | |
| Status: | Technology preview |
Dieser Typ befindet sich in der Technology Preview und kann sich noch ändern.
Eigenschaften
- first : SubIndicatorStyle
- foreground : DelegateStyle
- second : SubIndicatorStyle
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.