Switch QML Type

Schaltfläche, die ein- und ausgeschaltet werden kann. Mehr...

• Liste aller Elemente, einschließlich der vererbten Elemente

Eigenschaften

• position : real
• visualPosition : real

Ausführliche Beschreibung

Ein Schalter ist ein Optionsfeld, das per Ziehen verschoben oder ein- (aktiviert) bzw. ausgeschaltet (deaktiviert) werden kann. Schalter werden in der Regel verwendet, um zwischen zwei Zuständen zu wählen. Bei einer größeren Anzahl von Optionen, wie beispielsweise in einer Liste, sollten Sie stattdessen die Verwendung von „ SwitchDelegate “ in Betracht ziehen.

„Switch“ erbt seine API von „ AbstractButton “. So lässt sich beispielsweise der Zustand des Schalters mit der Eigenschaft „ checked “ festlegen. Die Signale „ clicked “ und „ AbstractButton::toggled “ werden ausgelöst, wenn der Schalter vom Benutzer interaktiv per Touch, Maus oder Tastatur angeklickt wird.

ColumnLayout {
    Switch {
        text: qsTr("Wi-Fi")
        checked: Networking.wifiEnabled
        onClicked: Networking.wifiEnabled = checked
    }
    Switch {
        text: qsTr("Bluetooth")
        checked: Networking.bluetoothEnabled
        onClicked: Networking.bluetoothEnabled = checked
    }
}

Siehe auch „Anpassen von Schalter- und Schaltflächen-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 Indikators 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-Schreibrichtungen. Um beispielsweise festzustellen, ob der Schieberegler über die Mitte hinausgezogen wurde, sollte stattdessen der logische Wert „ position “ verwendet werden.

Siehe auch position.