Auf dieser Seite

SwitchDelegate QML Type

Element-Delegat mit einem Schalter, der ein- oder ausgeschaltet werden kann. Mehr...

Import Statement: import QtQuick.Controls
Inherits:

ItemDelegate

Eigenschaften

Ausführliche Beschreibung

SwitchDelegate stellt einen Element-Delegaten dar, der ein- (markiert) oder ausgeschaltet (unmarkiert) werden kann. Switch-Delegaten werden typischerweise verwendet, um eine oder mehrere Optionen aus einer Reihe von Optionen auszuwählen. Bei kleineren Optionsmengen oder bei Optionen, die eindeutig identifizierbar sein müssen, sollten Sie stattdessen die Verwendung von Switch in Betracht ziehen.

„SwitchDelegate“ erbt seine API von „ ItemDelegate “, das wiederum von „ AbstractButton “ abgeleitet ist. So können Sie beispielsweise „ text “ festlegen und mithilfe der „ AbstractButton “-API auf „ clicks “ reagieren. Der Status des Switch-Delegaten kann über die Eigenschaft „ checked “ festgelegt werden.

ListView {
    model: ["Option 1", "Option 2", "Option 3"]
    delegate: SwitchDelegate {
        text: modelData
    }
}

Siehe auch „Anpassen von SwitchDelegate und Delegate-Steuerelementen“.

Dokumentation zu den Eigenschaften

position : real [read-only]

Diese Eigenschaft gibt die logische Position des Daumen-Indikators an.

Die Position wird als Bruchteil der Größe des Indikators im Bereich von 0.0 bis 1.0 angegeben. Anhand der Position lässt sich beispielsweise feststellen, ob der Schieberegler über die Mitte hinausgezogen wurde. Zur Visualisierung eines Schiebereglers sollte stattdessen die rechts-nach-links-fähige Funktion „ visualPosition “ verwendet werden.

Siehe auch visualPosition.

visualPosition : real [read-only]

Diese Eigenschaft gibt die visuelle Position des Schiebereglers an.

Die Position wird als Bruchteil der Größe des Schiebereglers im Bereich von 0.0 bis 1.0 angegeben. Wenn das Steuerelement auf „ mirrored “ gesetzt ist, entspricht der Wert 1.0 - position. Dadurch eignet sich der Wert zur Visualisierung des Schiebereglers unter Berücksichtigung der Unterstützung von Rechts-nach-Links-Schrift. Um beispielsweise festzustellen, ob der Schieberegler über die Mitte hinausgezogen wurde, sollte stattdessen der logische Wert „ position “ verwendet werden.

Siehe auch position.

© 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.