QComboBox Class

Dokumentation zu den Mitgliedsfunktionen

[explicit] QComboBox::QComboBox(QWidget *parent = nullptr)

Erstellt eine Combobox mit dem angegebenen „ parent “ unter Verwendung des Standardmodells „ QStandardItemModel “.

[virtual noexcept] QComboBox::~QComboBox()

Löscht die Combobox.

[signal] void QComboBox::activated(int index)

Dieses Signal wird gesendet, wenn der Benutzer einen Eintrag in der Combobox auswählt. Dabei wird die ID des Eintrags („ index “) übergeben. Beachten Sie, dass dieses Signal auch dann gesendet wird, wenn sich die Auswahl nicht ändert. Wenn Sie wissen möchten, wann sich die Auswahl tatsächlich ändert, verwenden Sie das Signal „ currentIndexChanged()“ oder „ currentTextChanged()“.

void QComboBox::addItem(const QString &text, const QVariant &userData = QVariant())

Fügt der Combobox einen Eintrag mit der angegebenen „ text “ hinzu, der die angegebene „ userData “ enthält (gespeichert in der „ Qt::UserRole “). Der Eintrag wird an das Ende der Liste der vorhandenen Einträge angehängt.

void QComboBox::addItem(const QIcon &icon, const QString &text, const QVariant &userData = QVariant())

Fügt der Combobox einen Eintrag mit den angegebenen Werten „ icon “ und „ text “ hinzu, der den angegebenen Wert „ userData “ enthält (gespeichert in „ Qt::UserRole “). Der Eintrag wird an das Ende der Liste der vorhandenen Einträge angehängt.

void QComboBox::addItems(const QStringList &texts)

Fügt jede der Zeichenfolgen aus dem angegebenen „ texts “ zur Combobox hinzu. Jedes Element wird nacheinander an die Liste der vorhandenen Elemente angehängt.

[override virtual protected] void QComboBox::changeEvent(QEvent *e)

Umsetzt: QWidget::changeEvent(QEvent *event).

[slot] void QComboBox::clear()

Löscht den Inhalt der Combobox und entfernt alle Einträge.

Hinweis: Wenn Sie für die Kombinationsliste ein externes Modell festgelegt haben, wird dieses Modell beim Aufruf dieser Funktion ebenfalls gelöscht.

[slot] void QComboBox::clearEditText()

Löscht den Inhalt des Eingabefelds, das zur Bearbeitung in der Combobox verwendet wird.

QCompleter *QComboBox::completer() const

Gibt den „Completer“ zurück, der zur automatischen Vervollständigung der Texteingabe für die Combobox verwendet wird.

Siehe auch setCompleter() und editable.

[override virtual protected] void QComboBox::contextMenuEvent(QContextMenuEvent *e)

Implementiert: ` QWidget::contextMenuEvent(QContextMenuEvent *event)`.

[signal] void QComboBox::currentIndexChanged(int index)

Dieses Signal wird immer dann ausgelöst, wenn sich die Eigenschaft „ currentIndex “ in der Combobox entweder durch eine Benutzeraktion oder programmgesteuert ändert. Dabei wird die Eigenschaft „ index “ des Elements übergeben oder der Wert -1, falls die Combobox leer wird oder die Eigenschaft „ currentIndex “ zurückgesetzt wurde.

[signal] void QComboBox::currentTextChanged(const QString &text)

Dieses Signal wird immer dann ausgelöst, wenn sich currentText ändert. Der neue Wert wird als text übergeben.

[signal] void QComboBox::editTextChanged(const QString &text)

Dieses Signal wird ausgelöst, wenn der Text im Zeileneingabefeld der Combobox geändert wird. Der neue Text wird durch ` text` angegeben.

[override virtual] bool QComboBox::event(QEvent *event)

Umsetzt: ` QWidget::event(QEvent *event)`.

int QComboBox::findData(const QVariant &data, int role = Qt::UserRole, Qt::MatchFlags flags = static_cast<Qt::MatchFlags>(Qt::MatchExactly|Qt::MatchCaseSensitive)) const

Gibt den Index des Elements zurück, das die angegebenen „ data “ für die angegebene „ role “ enthält; andernfalls wird -1 zurückgegeben.

Die „ flags “ legen fest, wie die Elemente in der Combobox durchsucht werden.

int QComboBox::findText(const QString &text, Qt::MatchFlags flags = Qt::MatchExactly|Qt::MatchCaseSensitive) const

Gibt den Index des Elements zurück, das die angegebene „ text “ enthält; andernfalls wird -1 zurückgegeben.

Die „ flags “ legen fest, wie die Elemente in der Combobox durchsucht werden.

[override virtual protected] void QComboBox::focusInEvent(QFocusEvent *e)

Implementiert: ` QWidget::focusInEvent(QFocusEvent *event)`.

[override virtual protected] void QComboBox::focusOutEvent(QFocusEvent *e)

Implementiert: ` QWidget::focusOutEvent(QFocusEvent *event)`.

[override virtual protected] void QComboBox::hideEvent(QHideEvent *e)

Implementiert: ` QWidget::hideEvent(QHideEvent *event)`.

[virtual] void QComboBox::hidePopup()

Blendet die Liste der Elemente in der Combobox aus, sofern diese gerade sichtbar ist, und setzt den internen Zustand zurück, sodass – falls das benutzerdefinierte Popup innerhalb der neu implementierten Funktion ` showPopup()` angezeigt wurde – müssen Sie auch die Funktion `hidePopup()` neu implementieren, um Ihr benutzerdefiniertes Popup auszublenden, und die Implementierung der Basisklasse aufrufen, um den internen Zustand zurückzusetzen, sobald Ihr benutzerdefiniertes Popup-Widget ausgeblendet wird.

Siehe auch ` showPopup()`.

[signal] void QComboBox::highlighted(int index)

Dieses Signal wird ausgelöst, wenn der Benutzer einen Eintrag in der Popup-Liste der Kombinationsfelds markiert. Dabei wird die ID des Eintrags („ index “) übergeben.

[virtual protected] void QComboBox::initStyleOption(QStyleOptionComboBox *option) const

Initialisieren Sie ` option ` mit den Werten aus dieser Datei: QComboBox. Diese Methode ist für Unterklassen nützlich, wenn diese ein ` QStyleOptionComboBox` benötigen, aber nicht alle Informationen selbst eingeben möchten.

Siehe auch ` QStyleOption::initFrom()`.

[override virtual protected] void QComboBox::inputMethodEvent(QInputMethodEvent *e)

Implementiert: QWidget::inputMethodEvent(QInputMethodEvent *event).

[override virtual] QVariant QComboBox::inputMethodQuery(Qt::InputMethodQuery query) const

Implementiert neu: ` QWidget::inputMethodQuery` (Qt::InputMethodQuery query) const.

void QComboBox::insertItem(int index, const QString &text, const QVariant &userData = QVariant())

Fügt die Elemente „ text “ und „ userData “ (die in der Datei „ Qt::UserRole “ gespeichert sind) in die Combobox unter der angegebenen Adresse „ index “ ein.

Ist der Index gleich oder größer als die Gesamtanzahl der Elemente, wird das neue Element an das Ende der Liste der vorhandenen Elemente angehängt. Ist der Index null oder negativ, wird das neue Element an den Anfang der Liste der vorhandenen Elemente eingefügt.

Siehe auch insertItems().

void QComboBox::insertItem(int index, const QIcon &icon, const QString &text, const QVariant &userData = QVariant())

Fügt die Elemente „ icon “, „ text “ und „ userData “ (die in der Datei „ Qt::UserRole “ gespeichert sind) in die Combobox unter der angegebenen Adresse „ index “ ein.

Ist der Index gleich oder größer als die Gesamtanzahl der Elemente, wird das neue Element an das Ende der Liste der vorhandenen Elemente angehängt. Ist der Index null oder negativ, wird das neue Element an den Anfang der Liste der vorhandenen Elemente eingefügt.

Siehe auch ` insertItems()`.

void QComboBox::insertItems(int index, const QStringList &list)

Fügt die Zeichenfolgen aus dem „ list “ als separate Einträge in die Combobox ein, beginnend mit dem angegebenen Index „ index “.

Ist der Index gleich oder größer als die Gesamtzahl der Elemente, werden die neuen Elemente an das Ende der Liste der vorhandenen Elemente angehängt. Ist der Index null oder negativ, werden die neuen Elemente an den Anfang der Liste der vorhandenen Elemente eingefügt.

Siehe auch insertItem().

void QComboBox::insertSeparator(int index)

Fügt ein Trennelement an der angegebenen Position index in die Combobox ein.

Ist der Index gleich oder größer als die Gesamtzahl der Elemente, wird das neue Element an das Ende der Liste der vorhandenen Elemente angehängt. Ist der Index null oder negativ, wird das neue Element vor die Liste der vorhandenen Elemente eingefügt.

Siehe auch insertItem().

QVariant QComboBox::itemData(int index, int role = Qt::UserRole) const

Gibt die Daten für die angegebene Rolle „ role “ in der angegebenen Rolle „ index “ in der Combobox zurück oder einen ungültigen Wert „ QVariant “, falls für diese Rolle keine Daten vorhanden sind.

Siehe auch setItemData().

QAbstractItemDelegate *QComboBox::itemDelegate() const

Gibt den von der Popup-Listenansicht verwendeten Element-Delegaten zurück.

Siehe auch „ setItemDelegate()“.

QIcon QComboBox::itemIcon(int index) const

Gibt das Symbol für das angegebene „ index “ in der Combobox zurück.

Siehe auch setItemIcon().

QString QComboBox::itemText(int index) const

Gibt den Text für die angegebene „ index “ in der Combobox zurück.

Siehe auch ` setItemText()` ().

[override virtual protected] void QComboBox::keyPressEvent(QKeyEvent *e)

Implementiert: ` QWidget::keyPressEvent(QKeyEvent *event)`.

[override virtual protected] void QComboBox::keyReleaseEvent(QKeyEvent *e)

Implementiert: ` QWidget::keyReleaseEvent(QKeyEvent *event)`.

QLineEdit *QComboBox::lineEdit() const

Gibt das Eingabefeld zurück, das zum Bearbeiten von Elementen in der Combobox verwendet wird, oder „ nullptr “, falls kein Eingabefeld vorhanden ist.

Nur bearbeitbare Kombinationsfelder verfügen über ein Eingabefeld.

Siehe auch „ setLineEdit()“.

[override virtual] QSize QComboBox::minimumSizeHint() const

Implementiert eine Zugriffsfunktion für die Eigenschaft „ QWidget::minimumSizeHint “ neu.

QAbstractItemModel *QComboBox::model() const

Gibt das von der Combobox verwendete Modell zurück.

Siehe auch ` setModel()`.

[override virtual protected] void QComboBox::mousePressEvent(QMouseEvent *e)

Implementiert: ` QWidget::mousePressEvent` (`QMouseEvent *event`).

[override virtual protected] void QComboBox::mouseReleaseEvent(QMouseEvent *e)

Implementiert: ` QWidget::mouseReleaseEvent` (`QMouseEvent *event`).

[override virtual protected] void QComboBox::paintEvent(QPaintEvent *e)

Umsetzt: ` QWidget::paintEvent` (`QPaintEvent *event`).

void QComboBox::removeItem(int index)

Entfernt das Element an der angegebenen Position index aus der Combobox. Dabei wird der aktuelle Index aktualisiert, falls der Index entfernt wird.

Diese Funktion führt keine Aktion aus, wenn „ index “ außerhalb des zulässigen Bereichs liegt.

[override virtual protected] void QComboBox::resizeEvent(QResizeEvent *e)

Implementiert: ` QWidget::resizeEvent(QResizeEvent *event)`.

QModelIndex QComboBox::rootModelIndex() const

Gibt den Index des Stammmodells für die Elemente in der Combobox zurück.

Siehe auch „ setRootModelIndex()“.

void QComboBox::setCompleter(QCompleter *completer)

Legt fest, welche „ completer “ anstelle des aktuellen Vervollständigers verwendet werden soll. Wenn „ completer “ auf „ nullptr “ gesetzt ist, wird die automatische Vervollständigung deaktiviert.

Standardmäßig wird für ein bearbeitbares Kombinationsfeld automatisch ein „ QCompleter “ erstellt, der eine groß-/kleinschreibungsunabhängige Inline-Vervollständigung durchführt.

Siehe auch completer().

[slot] void QComboBox::setEditText(const QString &text)

Legt den Wert „ text “ im Textfeld der Kombinationsliste fest.

void QComboBox::setItemData(int index, const QVariant &value, int role = Qt::UserRole)

Setzt die Daten role für das Element unter der angegebenen index in der Combobox auf die angegebene value.

Siehe auch ` itemData()`.

void QComboBox::setItemDelegate(QAbstractItemDelegate *delegate)

Legt das Element „ delegate “ für die Popup-Listenansicht fest. Die Combobox übernimmt die Verantwortung für den Delegaten.

Ein eventuell vorhandener Delegat wird entfernt, jedoch nicht gelöscht. „ QComboBox “ übernimmt nicht die Verantwortung für „ delegate “.

Siehe auch ` itemDelegate()`.

void QComboBox::setItemIcon(int index, const QIcon &icon)

Legt die Eigenschaft „ icon “ für das Element mit der angegebenen ID „ index “ in der Combobox fest.

Siehe auch „ itemIcon()“.

void QComboBox::setItemText(int index, const QString &text)

Legt die Eigenschaft „ text “ für das Element mit der angegebenen ID „ index “ in der Combobox fest.

Siehe auch itemText().

void QComboBox::setLineEdit(QLineEdit *edit)

Legt das Line- edit -Element fest, das anstelle des aktuellen Line-Edit-Widgets verwendet werden soll.

Die Kombinationsfeld übernimmt die Kontrolle über das Zeilenbearbeitungsfeld.

Siehe auch ` lineEdit()`.

[virtual] void QComboBox::setModel(QAbstractItemModel *model)

Setzt das Modell auf „ model “. „ model “ darf nicht „ nullptr “ sein. Wenn Sie den Inhalt eines Modells löschen möchten, rufen Sie „ clear()“ auf.

Siehe auch model(), clear() und setCompleter().

void QComboBox::setRootModelIndex(const QModelIndex &index)

Legt das Stammmodellelement „ index “ für die Elemente in der Combobox fest.

Siehe auch ` rootModelIndex()`.

void QComboBox::setValidator(const QValidator *validator)

Legt den „ validator “ fest, der anstelle des aktuellen Validators verwendet werden soll.

Siehe auch ` validator()`.

void QComboBox::setView(QAbstractItemView *itemView)

Legt die im Popup-Fenster der Combobox zu verwendende Ansicht auf die angegebene „ itemView “ fest. Die Combobox übernimmt die Verantwortung für die Ansicht.

Hinweis: Wenn Sie die Komfortansichten (wie QListWidget, QTableWidget oder QTreeWidget) verwenden möchten, stellen Sie sicher, dass Sie setModel() auf der Combobox mit dem Modell der Komfort-Widgets aufrufen, bevor Sie diese Funktion aufrufen.

Siehe auch view().

[override virtual protected] void QComboBox::showEvent(QShowEvent *e)

Implementiert: QWidget::showEvent(QShowEvent *event).

[virtual] void QComboBox::showPopup()

Zeigt die Liste der Elemente in der Combobox an. Ist die Liste leer, werden keine Elemente angezeigt.

Wenn Sie diese Funktion neu implementieren, um ein benutzerdefiniertes Popup-Fenster anzuzeigen, stellen Sie sicher, dass Sie ` hidePopup()` aufrufen, um den internen Zustand zurückzusetzen.

Siehe auch ` hidePopup()`.

[override virtual] QSize QComboBox::sizeHint() const

Implementiert eine Zugriffsfunktion für die Eigenschaft „ QWidget::sizeHint “ neu.

Diese Implementierung speichert den Größenhinweis im Cache, um eine Größenanpassung zu vermeiden, wenn sich der Inhalt dynamisch ändert. Um den zwischengespeicherten Wert zu ungültig zu machen, ändern Sie den Wert von ` sizeAdjustPolicy`.

[signal] void QComboBox::textActivated(const QString &text)

Dieses Signal wird gesendet, wenn der Benutzer einen Eintrag in der Combobox auswählt. Dabei wird die ID des Eintrags („ text “) übergeben. Beachten Sie, dass dieses Signal auch dann gesendet wird, wenn sich die Auswahl nicht ändert. Wenn Sie wissen möchten, wann sich die Auswahl tatsächlich ändert, verwenden Sie das Signal „ currentIndexChanged()“ oder „ currentTextChanged()“.

[signal] void QComboBox::textHighlighted(const QString &text)

Dieses Signal wird ausgelöst, wenn der Benutzer einen Eintrag in der Popup-Liste der Combobox markiert. Dabei wird die ID des Eintrags ( text ) übergeben.

const QValidator *QComboBox::validator() const

Gibt den Validator zurück, der zur Einschränkung der Texteingabe für die Combobox verwendet wird.

Siehe auch setValidator() und editable.

QAbstractItemView *QComboBox::view() const

Gibt die Listenansicht zurück, die für das Popup-Fenster der Combobox verwendet wird.

Siehe auch setView().

[override virtual protected] void QComboBox::wheelEvent(QWheelEvent *e)

Implementiert: ` QWidget::wheelEvent` (`QWheelEvent *event`).