ComboBox QML Type

Diese Eigenschaft gibt an, ob das Kombinationsfeld akzeptablen Text im bearbeitbaren Textfeld enthält.

Wenn ein Validator gesetzt wurde, ist der Wert nur dann true, wenn der aktuelle Text für den Validator als endgültige Zeichenkette akzeptabel ist (nicht als Zwischenzeichenkette).

Diese Eigenschaft wurde in QtQuick.Controls 2.2 (Qt 5.9) eingeführt.

Siehe auch validator und accepted.

Diese Eigenschaft enthält die Anzahl der Elemente in der Combobox.

Diese Eigenschaft enthält den Index des aktuellen Elements in der Combobox.

Der Standardwert ist -1, wenn count 0 ist, und ansonsten 0.

Siehe auch activated(), currentText, und highlightedIndex.

Diese Eigenschaft enthält den Text des aktuellen Eintrags in der Combobox.

Siehe auch currentIndex, displayText, textRole, und editText.

Diese Eigenschaft enthält den Wert des aktuellen Eintrags im Kombinationsfeld.

Ein Beispiel für die Verwendung dieser Eigenschaft finden Sie unter ComboBox Model Roles.

Diese Eigenschaft wurde in QtQuick.Controls 2.14 (Qt 5.14) eingeführt.

Siehe auch currentIndex, currentText, und valueRole.

Diese Eigenschaft enthält einen Delegaten, der ein Element im Popup-Fenster des Kombinationsfeldes anzeigt.

Es wird empfohlen, ItemDelegate (oder ein anderes Derivat von AbstractButton ) als Delegat zu verwenden. Dadurch wird sichergestellt, dass die Interaktion wie erwartet funktioniert und das Popup-Fenster automatisch geschlossen wird, wenn dies erforderlich ist. Wenn andere Typen als Delegat verwendet werden, muss das Popup-Fenster manuell geschlossen werden. Zum Beispiel, wenn MouseArea verwendet wird:

delegate: Rectangle {
    // ...
    MouseArea {
        // ...
        onClicked: comboBox.popup.close()
    }
}

Siehe auch ItemDelegate und ComboBox anpassen.

Diese Eigenschaft enthält das Modell, das Delegateninstanzen für das Kombinationsfeld bereitstellt.

Sie wird normalerweise einem ListView in der contentItem der popup zugewiesen.

Siehe auch ComboBox anpassen.

Diese Eigenschaft enthält den Text, der auf der Schaltfläche des Kombinationsfeldes angezeigt wird.

Standardmäßig zeigt der Anzeigetext die aktuelle Auswahl an. Das heißt, er folgt dem Text des aktuellen Elements. Der Standardanzeigetext kann jedoch durch einen benutzerdefinierten Wert überschrieben werden.

ComboBox {
    currentIndex: 1
    displayText: "Size: " + currentText
    model: ["S", "M", "L"]
}

Siehe auch currentText und textRole.

Diese Eigenschaft gibt an, ob die Schaltfläche des Kombinationsfeldes visuell gedrückt ist.

Sofern nicht explizit festgelegt, ist diese Eigenschaft true, wenn entweder pressed oder popup.visible true ist. Um zum Standardwert zurückzukehren, setzen Sie diese Eigenschaft auf undefined.

Diese Eigenschaft wurde in QtQuick.Controls 2.2 (Qt 5.9) eingeführt.

Siehe auch pressed und popup.

Diese Eigenschaft enthält den Text im Textfeld eines editierbaren Kombinationsfeldes.

Diese Eigenschaft wurde in QtQuick.Controls 2.2 (Qt 5.9) eingeführt.

Siehe auch editable, currentText, und displayText.

Diese Eigenschaft gibt an, ob das Kombinationsfeld editierbar ist.

Der Standardwert ist false.

Diese Eigenschaft wurde in QtQuick.Controls 2.2 (Qt 5.9) eingeführt.

Siehe auch validator.

Diese Eigenschaft gibt an, ob die Schaltfläche des Kombinationsfeldes flach ist.

Ein flacher Kombinationsfeld-Button zeichnet keinen Hintergrund, es sei denn, es wird mit ihm interagiert. Im Vergleich zu normalen Kombinationsfeldern bieten flache Kombinationsfelder ein Aussehen, das sie weniger vom Rest der Benutzeroberfläche abhebt. Wenn Sie zum Beispiel ein Kombinationsfeld in einer Symbolleiste platzieren, kann es wünschenswert sein, das Kombinationsfeld flach zu gestalten, damit es besser zum flachen Aussehen der Symbolleisten-Schaltflächen passt.

Der Standardwert ist false.

Diese Eigenschaft wurde in QtQuick.Controls 2.1 (Qt 5.8) eingeführt.

Diese Eigenschaft enthält den Index des hervorgehobenen Elements in der Popup-Liste des Kombinationsfeldes.

Wenn ein hervorgehobenes Element aktiviert wird, wird das Popup geschlossen, currentIndex wird auf highlightedIndex gesetzt und der Wert dieser Eigenschaft wird auf -1 zurückgesetzt, da es kein hervorgehobenes Element mehr gibt.

Siehe auch highlighted() und currentIndex.

Diese Eigenschaft steuert, wie die implicitContentWidth der ComboBox berechnet wird.

Wenn die Breite von ComboBox nicht groß genug ist, um Text anzuzeigen, wird dieser Text ausgelassen. Je nachdem, welche Teile des Textes ausgelassen werden, kann dies die Auswahl eines Elements für den Endbenutzer schwierig machen. Eine effiziente Methode, um sicherzustellen, dass eine ComboBox breit genug ist, um zu vermeiden, dass Text ausgelassen wird, besteht darin, eine Breite festzulegen, von der man weiß, dass sie groß genug ist:

width: 300
implicitContentWidthPolicy: ComboBox.ContentItemImplicitWidth

Es ist jedoch oft nicht möglich zu wissen, ob ein fest kodierter Wert groß genug ist oder nicht, da die Größe von Text von vielen Faktoren abhängt, wie z. B. Schriftfamilie, Schriftgröße, Übersetzungen usw.

implicitContentWidthPolicy bietet eine einfache Möglichkeit zu steuern, wie die implicitContentWidth berechnet wird, was sich wiederum auf die implicitWidth der ComboBox auswirkt und sicherstellt, dass der Text nicht ausgelassen wird.

Die verfügbaren Werte sind:

Der Standardwert ist ContentItemImplicitWidth.

Da sich diese Eigenschaft nur auf die implicitWidth des ComboBox auswirkt, kann das Setzen eines expliziten width immer noch zu Eliding führen.

Diese Eigenschaft wurde in QtQuick.Controls 6.0 (Qt 6.0) eingeführt.

Diese Eigenschaft enthält die implizite Indikatorhöhe.

Der Wert ist gleich indicator ? indicator.implicitHeight : 0.

Diese Eigenschaft wird normalerweise zusammen mit implicitContentHeight und implicitBackgroundHeight verwendet, um implicitHeight zu berechnen.

Diese Eigenschaft wurde in QtQuick.Controls 2.5 (Qt 5.12) eingeführt.

Siehe auch implicitIndicatorWidth.

Diese Eigenschaft enthält die implizite Indikatorbreite.

Der Wert ist gleich indicator ? indicator.implicitWidth : 0.

Diese Eigenschaft wird normalerweise zusammen mit implicitContentWidth und implicitBackgroundWidth verwendet, um implicitWidth zu berechnen.

Diese Eigenschaft wurde in QtQuick.Controls 2.5 (Qt 5.12) eingeführt.

Siehe auch implicitIndicatorHeight.

Diese Eigenschaft enthält das Drop-Indikator-Element.

Siehe auch ComboBox anpassen.

Diese Eigenschaft gibt an, ob ein editierbares Kombinationsfeld eine partielle Texteingabe durch eine Eingabemethode hat.

Während des Zusammensetzens kann eine Eingabemethode auf Maus- oder Tastenereignisse von der Combobox angewiesen sein, um den Teiltext zu bearbeiten oder zu bestätigen. Diese Eigenschaft kann verwendet werden, um zu bestimmen, wann Event-Handler, die den korrekten Betrieb einer Eingabemethode stören könnten, deaktiviert werden sollen.

Diese Eigenschaft wurde in QtQuick.Controls 2.2 (Qt 5.9) eingeführt.

Liefert der Eingabemethode Hinweise über den erwarteten Inhalt der Combobox und wie sie funktionieren soll.

Der Standardwert ist Qt.ImhNoPredictiveText.

Der Wert ist eine bitweise Kombination von Flags oder Qt.ImhNone, wenn keine Hinweise gesetzt sind.

Flags, die das Verhalten verändern, sind:

• Qt.ImhHiddenText - Zeichen sollten versteckt werden, wie es typischerweise bei der Eingabe von Passwörtern verwendet wird.
• Qt.ImhSensitiveData - Eingegebener Text sollte von der aktiven Eingabemethode nicht in einem persistenten Speicher wie dem prädiktiven Benutzerwörterbuch gespeichert werden.
• Qt.ImhNoAutoUppercase - Die Eingabemethode sollte nicht versuchen, am Ende eines Satzes automatisch auf Großbuchstaben umzuschalten.
• Qt.ImhPreferNumbers - Zahlen werden bevorzugt (sind aber nicht erforderlich).
• Qt.ImhPreferUppercase - Großbuchstaben werden bevorzugt (sind aber nicht erforderlich).
• Qt.ImhPreferLowercase - Kleinbuchstaben werden bevorzugt (sind aber nicht erforderlich).
• Qt.ImhNoPredictiveText - Keine Textvorhersage (d.h. Wörterbuchsuche) während des Tippens verwenden.
• Qt.ImhDate - Der Texteditor funktioniert wie ein Datumsfeld.
• Qt.ImhTime - Der Texteditor funktioniert wie ein Zeitfeld.

Flags, die die Eingabe einschränken (exklusive Flags) sind:

• Qt.ImhDigitsOnly - Nur Ziffern sind erlaubt.
• Qt.ImhFormattedNumbersOnly - Nur die Eingabe von Zahlen ist erlaubt. Dies schließt Dezimalpunkt und Minuszeichen ein.
• Qt.ImhUppercaseOnly - Nur die Eingabe von Großbuchstaben ist erlaubt.
• Qt.ImhLowercaseOnly - Nur die Eingabe von Kleinbuchstaben ist erlaubt.
• Qt.ImhDialableCharactersOnly - Nur Zeichen, die für die Telefonwahl geeignet sind, sind erlaubt.
• Qt.ImhEmailCharactersOnly - Nur Zeichen, die für E-Mail-Adressen geeignet sind, sind erlaubt.
• Qt.ImhUrlCharactersOnly - Nur Zeichen, die für URLs geeignet sind, sind erlaubt.

Masken:

• Qt.ImhExclusiveInputMask - Diese Maske ergibt einen Wert ungleich Null, wenn eines der exklusiven Flags verwendet wird.

Diese Eigenschaft wurde in QtQuick.Controls 2.2 (Qt 5.9) eingeführt.

Diese Eigenschaft enthält das Modell, das die Daten für das Kombinationsfeld bereitstellt.

ComboBox {
    textRole: "key"
    model: ListModel {
        ListElement { key: "First"; value: 123 }
        ListElement { key: "Second"; value: 456 }
        ListElement { key: "Third"; value: 789 }
    }
}

Siehe auch textRole und Datenmodelle.

Diese Eigenschaft enthält das Popup.

Das Popup-Fenster kann bei Bedarf manuell geöffnet oder geschlossen werden:

onSpecialEvent: comboBox.popup.close()

Siehe auch ComboBox anpassen.

Diese Eigenschaft gibt an, ob die Schaltfläche des Kombinationsfeldes physisch gedrückt ist. Eine Schaltfläche kann entweder durch Berührung oder durch Tastenereignisse gedrückt werden.

Siehe auch down.

Diese Eigenschaft legt fest, ob das Textfeld für ein editierbares ComboBox mit der Maus ausgewählt werden kann.

Der Standardwert ist false.

Diese Eigenschaft wurde in QtQuick.Controls 2.15 (Qt 5.15) eingeführt.

Diese Eigenschaft enthält die Modellrolle, die zum Ausfüllen der Combobox verwendet wird.

Wenn das Modell mehrere Rollen hat, kann textRole gesetzt werden, um zu bestimmen, welche Rolle angezeigt werden soll.

Siehe auch model, currentText, displayText, und ComboBox Model Roles.

Diese Eigenschaft enthält eine Eingabetextprüfung für ein editierbares Kombinationsfeld.

Wenn ein Validator gesetzt ist, akzeptiert das Textfeld nur Eingaben, die die Texteigenschaft in einem Zwischenzustand belassen. Das Signal accepted wird nur ausgegeben, wenn sich der Text in einem akzeptablen Zustand befindet, wenn die Taste Return oder Enter gedrückt wird.

Die derzeit unterstützten Validatoren sind IntValidator, DoubleValidator und RegularExpressionValidator. Ein Beispiel für die Verwendung von Validatoren ist unten dargestellt, das die Eingabe von Ganzzahlen zwischen 0 und 10 in das Textfeld erlaubt:

ComboBox {
    model: 10
    editable: true
    validator: IntValidator {
        top: 9
        bottom: 0
    }
}

Diese Eigenschaft wurde in QtQuick.Controls 2.2 (Qt 5.9) eingeführt.

Siehe auch acceptableInput, accepted, und editable.

Diese Eigenschaft enthält die Modellrolle, die zum Speichern des Wertes verwendet wird, der mit jedem Element im Modell verbunden ist.

Ein Beispiel für die Verwendung dieser Eigenschaft finden Sie unter ComboBox Model Roles.

Diese Eigenschaft wurde in QtQuick.Controls 2.14 (Qt 5.14) eingeführt.

Siehe auch model und currentValue.

Dieses Signal wird ausgegeben, wenn die Taste Return oder Enter in einem Kombinationsfeld editable gedrückt wird.

Sie können dieses Signal verarbeiten, um z. B. das neu eingegebene Element dem Modell hinzuzufügen:

ComboBox {
    editable: true
    model: ListModel {
        id: model
        ListElement { text: "Banana" }
        ListElement { text: "Apple" }
        ListElement { text: "Coconut" }
    }
    onAccepted: {
        if (find(editText) === -1)
            model.append({text: editText})
    }
}

Bevor das Signal ausgegeben wird, wird geprüft, ob die Zeichenkette im Modell existiert. Ist dies der Fall, wird currentIndex auf den Index und currentText auf die Zeichenkette selbst gesetzt.

Nachdem das Signal ausgegeben wurde und die erste Prüfung fehlgeschlagen ist (d. h. das Element existiert nicht), wird eine weitere Prüfung durchgeführt, um festzustellen, ob das Element durch den Signalhandler hinzugefügt wurde. War dies der Fall, werden currentIndex und currentText entsprechend aktualisiert. Andernfalls werden sie auf -1 bzw. "" gesetzt.

Dieses Signal wurde in QtQuick.Controls 2.2 (Qt 5.9) eingeführt.

Dieses Signal wird ausgegeben, wenn das Element auf index durch den Benutzer aktiviert wird.

Ein Element wird aktiviert, wenn es ausgewählt wird, während das Popup geöffnet ist, was dazu führt, dass das Popup geschlossen wird (und currentIndex sich ändert), oder wenn das Popup geschlossen ist und das Kombinationsfeld über die Tastatur navigiert wird, was dazu führt, dass currentIndex sich ändert. Die Eigenschaft currentIndex wird auf index gesetzt.

Siehe auch currentIndex.

Dieses Signal wird ausgegeben, wenn das Element unter index in der Popup-Liste vom Benutzer hervorgehoben wird.

Das Signal highlighted wird nur ausgegeben, wenn das Popup geöffnet ist und ein Element hervorgehoben ist, aber nicht unbedingt activated.

Siehe auch highlightedIndex.

Verringert den aktuellen Index des Kombinationsfeldes bzw. den hervorgehobenen Index, wenn die Popup-Liste sichtbar ist.

Siehe auch currentIndex und highlightedIndex.

Gibt den Index des angegebenen text zurück, oder -1, wenn keine Übereinstimmung gefunden wird.

Die Art und Weise, wie die Suche durchgeführt wird, wird durch die angegebene Übereinstimmung flags definiert. Standardmäßig führt das Kombinationsfeld eine exakte Übereinstimmung unter Berücksichtigung der Groß- und Kleinschreibung durch (Qt.MatchExactly). Bei allen anderen Übereinstimmungsarten wird die Groß- und Kleinschreibung nicht beachtet, es sei denn, das Flag Qt.MatchCaseSensitive ist ebenfalls angegeben.

Ein Beispiel:

ComboBox {
    model: ListModel {
        ListElement { text: "Banana" }
        ListElement { text: "Apple" }
        ListElement { text: "Coconut" }
    }
    Component.onCompleted: currentIndex = find("Coconut")
}

Siehe auch textRole.

Erhöht den aktuellen Index des Kombinationsfeldes bzw. den hervorgehobenen Index, wenn die Popup-Liste sichtbar ist.

Siehe auch currentIndex und highlightedIndex.

Gibt den Index des angegebenen value zurück, oder -1, wenn keine Übereinstimmung gefunden wird.

Ein Beispiel für die Verwendung dieser Methode finden Sie unter ComboBox Model Roles.

Diese Methode wurde in QtQuick.Controls 2.14 (Qt 5.14) eingeführt.

Siehe auch find(), currentValue, currentIndex, valueRole, und valueAt.

Wählt den gesamten Text im bearbeitbaren Textfeld des Kombinationsfeldes aus.

Diese Methode wurde in QtQuick.Controls 2.2 (Qt 5.9) eingeführt.

Siehe auch editText.

Gibt den Text für den angegebenen index zurück, oder einen leeren String, wenn der Index außerhalb der Grenzen liegt.

Ein Beispiel:

ComboBox {
    model: ListModel {
        ListElement { text: "Banana" }
        ListElement { text: "Apple" }
        ListElement { text: "Coconut" }
    }
    onActivated: (index) => { print(textAt(index)) }
}

Siehe auch textRole.

Gibt den Wert an der Position index in der Combobox zurück.

Diese Methode wurde in QtQuick.Controls 2.14 (Qt 5.14) eingeführt.

Siehe auch indexOfValue.