QComboBox Class

Dokumentation der Mitgliedsfunktionen

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

Konstruiert eine Combobox mit dem angegebenen parent, wobei das Standardmodell QStandardItemModel verwendet wird.

[virtual noexcept] QComboBox::~QComboBox()

Zerstört die Combobox.

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

Dieses Signal wird gesendet, wenn der Benutzer ein Element in der Combobox auswählt. Es wird die index des Eintrags übergeben. Beachten Sie, dass dieses Signal auch gesendet wird, wenn die Auswahl nicht geändert wird. Wenn Sie wissen müssen, 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 mit der angegebenen text einen Eintrag hinzu, der die angegebene userData (gespeichert in Qt::UserRole) enthält. Der Eintrag wird an die Liste der vorhandenen Einträge angehängt.

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

Fügt der Combobox ein Element mit den angegebenen icon und text hinzu, das das angegebene userData enthält (gespeichert in Qt::UserRole). Der Eintrag wird an die Liste der vorhandenen Einträge angehängt.

void QComboBox::addItems(const QStringList &texts)

Fügt jede der Zeichenketten in der angegebenen texts in die Combobox ein. Jeder Eintrag wird der Reihe nach an die Liste der vorhandenen Einträge angehängt.

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

Reimplements: QWidget::changeEvent(QEvent *Event).

[slot] void QComboBox::clear()

Löscht die Combobox und entfernt alle Einträge.

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

[slot] void QComboBox::clearEditText()

Löscht den Inhalt der Bearbeitungszeile, die für die Bearbeitung in der Combobox verwendet wird.

QCompleter *QComboBox::completer() const

Gibt die Vervollständigung zurück, die für die automatische Vervollständigung der Texteingabe in der Combobox verwendet wird.

Siehe auch setCompleter() und editable.

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

Reimplements: QWidget::contextMenuEvent(QContextMenuEvent *event).

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

Dieses Signal wird immer dann gesendet, wenn sich die currentIndex in der Combobox entweder durch Benutzerinteraktion oder programmatisch ändert. Übergeben wird der Wert index oder -1, wenn die Combobox leer ist oder currentIndex zurückgesetzt wurde.

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

Dieses Signal wird ausgegeben, wenn sich currentText ändert. Der neue Wert wird als text übergeben.

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

Dieses Signal wird ausgegeben, wenn der Text im Zeileneditier-Widget der Combobox geändert wird. Der neue Text wird durch text angegeben.

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

Reimplements: 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 das angegebene data für das angegebene role enthält; andernfalls wird -1 zurückgegeben.

Die flags geben an, 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 den angegebenen text enthält; andernfalls wird -1 zurückgegeben.

Die flags geben an, wie die Elemente in der Combobox durchsucht werden.

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

Reimplements: QWidget::focusInEvent(QFocusEvent *event).

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

Reimplements: QWidget::focusOutEvent(QFocusEvent *event).

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

Reimplements: QWidget::hideEvent(QHideEvent *event).

[virtual] void QComboBox::hidePopup()

Blendet die Liste der Elemente in der Combobox aus, wenn sie gerade sichtbar ist, und setzt den internen Status zurück. Wenn also das benutzerdefinierte Popup in 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 Status zurückzusetzen, wenn Ihr benutzerdefiniertes Popup-Widget ausgeblendet wird.

Siehe auch showPopup().

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

Dieses Signal wird gesendet, wenn ein Element in der Combobox-Popup-Liste vom Benutzer hervorgehoben wird. Es wird die Adresse index des Eintrags übergeben.

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

Initialisieren Sie option mit den Werten aus dieser QComboBox. Diese Methode ist nützlich für Unterklassen, wenn sie eine QStyleOptionComboBox benötigen, aber nicht alle Informationen selbst eingeben wollen.

Siehe auch QStyleOption::initFrom().

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

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

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

Reimplements: QWidget::inputMethodQuery(Qt::InputMethodQuery query) const.

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

Fügt die text und userData (gespeichert in Qt::UserRole) in die Combobox an der angegebenen index ein.

Wenn der Index gleich oder höher ist als die Gesamtzahl der Einträge, wird der neue Eintrag an die Liste der vorhandenen Einträge angehängt. Ist der Index Null oder negativ, wird der neue Eintrag der Liste der vorhandenen Einträge vorangestellt.

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 (gespeichert in Qt::UserRole) in die Combobox an der angegebenen Stelle index ein.

Wenn der Index gleich oder höher ist als die Gesamtzahl der Einträge, wird der neue Eintrag an die Liste der vorhandenen Einträge angehängt. Ist der Index Null oder negativ, wird der neue Eintrag der Liste der vorhandenen Einträge vorangestellt.

Siehe auch insertItems().

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

Fügt die Zeichenketten aus list als separate Elemente in die Combobox ein, beginnend mit dem angegebenen index.

Ist der Index gleich oder größer als die Gesamtzahl der Einträge, werden die neuen Einträge an die Liste der vorhandenen Einträge angehängt. Ist der Index Null oder negativ, werden die neuen Einträge der Liste der vorhandenen Einträge vorangestellt.

Siehe auch insertItem().

void QComboBox::insertSeparator(int index)

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

Ist der Index gleich oder größer als die Gesamtzahl der Elemente, wird das neue Element an die Liste der vorhandenen Elemente angehängt. Ist der Index Null oder negativ, wird der neue Eintrag der Liste der vorhandenen Einträge vorangestellt.

Siehe auch insertItem().

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

Gibt die Daten für die angegebene role in der angegebenen index in der Combobox zurück, oder eine ungültige QVariant, wenn es keine Daten für diese Rolle gibt.

Siehe auch setItemData().

QAbstractItemDelegate *QComboBox::itemDelegate() const

Gibt den von der Popup-Listenansicht verwendeten Elementdelegaten 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 das angegebene index in der Combobox zurück.

Siehe auch setItemText().

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

Reimplements: QWidget::keyPressEvent(QKeyEvent *event).

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

Reimplements: QWidget::keyReleaseEvent(QKeyEvent *event).

QLineEdit *QComboBox::lineEdit() const

Gibt die Zeilenbearbeitung zurück, die zum Bearbeiten von Elementen in der Combobox verwendet wird, oder nullptr, wenn es keine Zeilenbearbeitung gibt.

Nur editierbare Comboboxen haben eine Zeilenbearbeitung.

Siehe auch setLineEdit().

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

Reimplantiert eine Zugriffsfunktion für die Eigenschaft: QWidget::minimumSizeHint.

QAbstractItemModel *QComboBox::model() const

Gibt das von der Combobox verwendete Modell zurück.

Siehe auch setModel().

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

Reimplements: QWidget::mousePressEvent(QMouseEvent *event).

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

Reimplements: QWidget::mouseReleaseEvent(QMouseEvent *event).

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

Reimplements: QWidget::paintEvent(QPaintEvent *event).

void QComboBox::removeItem(int index)

Entfernt den Eintrag unter der angegebenen Adresse index aus der Combobox. Dabei wird der aktuelle Index aktualisiert, wenn der Index entfernt wird.

Diese Funktion ist wirkungslos, wenn index außerhalb des Bereichs liegt.

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

Reimplements: 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, dass completer anstelle des aktuellen Vervollständigers verwendet wird. Wenn completer nullptr ist, ist die automatische Vervollständigung deaktiviert.

Standardmäßig wird für ein bearbeitbares Kombinationsfeld automatisch eine QCompleter erstellt, die eine Inline-Vervollständigung ohne Berücksichtigung der Groß-/Kleinschreibung durchführt.

Siehe auch completer().

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

Setzt die text in der Textbearbeitung der Combobox.

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

Setzt die Daten role für den Eintrag auf dem angegebenen index in der Combobox auf den angegebenen value.

Siehe auch itemData().

void QComboBox::setItemDelegate(QAbstractItemDelegate *delegate)

Legt das Element delegate für die Popup-Listenansicht fest. Die Combobox wird Eigentümer des Delegaten.

Ein eventuell vorhandener Delegat wird entfernt, aber nicht gelöscht. QComboBox übernimmt nicht das Eigentum an delegate.

Siehe auch itemDelegate().

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

Setzt die icon für den Eintrag auf der angegebenen index in der Combobox.

Siehe auch itemIcon().

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

Setzt die text für den Eintrag auf der angegebenen index in der Combobox.

Siehe auch itemText().

void QComboBox::setLineEdit(QLineEdit *edit)

Legt die Zeile edit fest, die anstelle des aktuellen Zeilenbearbeitungs-Widgets verwendet werden soll.

Die Combobox übernimmt den Besitz der Zeilenbearbeitung.

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 wollen, rufen Sie clear() auf.

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

void QComboBox::setRootModelIndex(const QModelIndex &index)

Legt das Root Model Item index für die Items 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)

Setzt die im Popup der Combobox zu verwendende Ansicht auf die angegebene itemView. Die Combobox übernimmt den Besitz der Ansicht.

Hinweis: Wenn Sie die Komfortansichten (wie QListWidget, QTableWidget oder QTreeWidget) verwenden wollen, müssen Sie vor dem Aufruf dieser Funktion setModel() für die Combobox mit dem Modell der Komfortwidgets aufrufen.

Siehe auch view().

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

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

[virtual] void QComboBox::showPopup()

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

Wenn Sie diese Funktion neu implementieren, um ein benutzerdefiniertes Pop-up anzuzeigen, stellen Sie sicher, dass Sie hidePopup() aufrufen, um den internen Status zurückzusetzen.

Siehe auch hidePopup().

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

Reimplementiert eine Zugriffsfunktion für die Eigenschaft: QWidget::sizeHint.

Diese Implementierung speichert den Größenhinweis, um eine Größenänderung zu vermeiden, wenn sich der Inhalt dynamisch ändert. Um den zwischengespeicherten Wert ungültig zu machen, ändern Sie die sizeAdjustPolicy.

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

Dieses Signal wird gesendet, wenn der Benutzer ein Element in der Combobox auswählt. Es wird die text des Elements übergeben. Beachten Sie, dass dieses Signal auch gesendet wird, wenn die Auswahl nicht geändert wird. Wenn Sie wissen müssen, wann sich die Auswahl tatsächlich ändert, verwenden Sie das Signal currentIndexChanged() oder currentTextChanged().

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

Dieses Signal wird gesendet, wenn ein Element in der Combobox-Popup-Liste vom Benutzer hervorgehoben wird. Es wird die Adresse text des Eintrags ü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 der Combobox verwendet wird.

Siehe auch setView().

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

Reimplements: QWidget::wheelEvent(QWheelEvent *event).