QListWidget Class

QListWidget *listWidget = new QListWidget(this);

new QListWidgetItem(tr("Oak"), listWidget);
new QListWidgetItem(tr("Fir"), listWidget);
new QListWidgetItem(tr("Pine"), listWidget);

QListWidgetItem *newItem = new QListWidgetItem;
newItem->setText(itemText);
listWidget->insertItem(row, newItem);

Dokumentation der Mitgliedsfunktionen

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

Erstellt ein leeres QListWidget mit dem angegebenen „ parent “.

[virtual noexcept] QListWidget::~QListWidget()

Löscht das Listen-Widget und alle darin enthaltenen Elemente.

void QListWidget::addItem(QListWidgetItem *item)

Fügt das „ item “ am Ende des Listen-Widgets ein.

Siehe auch „ insertItem()“.

void QListWidget::addItem(const QString &label)

Fügt am Ende des Listen-Widgets einen Eintrag mit dem Text „ label “ ein.

void QListWidget::addItems(const QStringList &labels)

Fügt am Ende des Listen-Widgets einen Eintrag mit dem Text „ labels “ ein.

Siehe auch insertItems().

[slot] void QListWidget::clear()

Entfernt alle Elemente und Markierungen aus der Ansicht.

void QListWidget::closePersistentEditor(QListWidgetItem *item)

Schließt den persistenten Editor für den angegebenen item.

Siehe auch ` openPersistentEditor()` und ` isPersistentEditorOpen()`.

QListWidgetItem *QListWidget::currentItem() const

Gibt das aktuelle Element zurück.

Siehe auch „ setCurrentItem()“.

[signal] void QListWidget::currentItemChanged(QListWidgetItem *current, QListWidgetItem *previous)

Dieses Signal wird immer dann ausgelöst, wenn sich das aktuelle Element ändert.

previous ist das Element, das zuvor den Fokus hatte; current ist das neue aktuelle Element.

[signal] void QListWidget::currentRowChanged(int currentRow)

Dieses Signal wird immer dann ausgelöst, wenn sich das aktuelle Element ändert.

currentRow ist die Zeilennummer des aktuellen Elements. Wenn kein aktuelles Element vorhanden ist, ist der „ currentRow “ -1.

[signal] void QListWidget::currentTextChanged(const QString &currentText)

Dieses Signal wird immer dann ausgelöst, wenn sich der aktuelle Eintrag ändert.

currentText bezeichnet die Textdaten des aktuellen Elements. Wenn kein aktuelles Element vorhanden ist, ist die „ currentText “ ungültig.

[override virtual protected] void QListWidget::dropEvent(QDropEvent *event)

Implementiert: ` QListView::dropEvent(QDropEvent *event)`.

[virtual protected] bool QListWidget::dropMimeData(int index, const QMimeData *data, Qt::DropAction action)

Verarbeitet den von einem externen Drag-and-Drop-Vorgang bereitgestellten „ data “, der mit dem angegebenen „ action “ im angegebenen „ index “ endete. Gibt „ true “ zurück, wenn „ data “ und „ action “ vom Modell verarbeitet werden können; andernfalls wird „ false “ zurückgegeben.

Siehe auch supportedDropActions() und supportedDragActions.

void QListWidget::editItem(QListWidgetItem *item)

Beginnt mit der Bearbeitung der „ item “, sofern diese bearbeitbar ist.

[override virtual protected] bool QListWidget::event(QEvent *e)

Implementiert: ` QListView::event(QEvent *e)`.

QList<QListWidgetItem *> QListWidget::findItems(const QString &text, Qt::MatchFlags flags) const

Sucht mithilfe der angegebenen Suchanfrage „ flags “ nach Einträgen, deren Text mit der Zeichenfolge „ text “ übereinstimmt.

QModelIndex QListWidget::indexFromItem(const QListWidgetItem *item) const

Gibt den QModelIndex zurück, der mit dem angegebenen item verknüpft ist.

void QListWidget::insertItem(int row, QListWidgetItem *item)

Fügt den Eintrag „ item “ an der durch „ row “ angegebenen Position in der Liste ein.

Siehe auch addItem().

void QListWidget::insertItem(int row, const QString &label)

Fügt einen Eintrag mit dem Text „ label “ in das Listen-Widget an der durch „ row “ angegebenen Position ein.

Siehe auch addItem().

void QListWidget::insertItems(int row, const QStringList &labels)

Fügt Elemente aus der Liste „ labels “ in die Liste ein, beginnend mit dem angegebenen Element „ row “.

Siehe auch insertItem() und addItem().

bool QListWidget::isPersistentEditorOpen(QListWidgetItem *item) const

Gibt zurück, ob für das Element „ item “ ein persistenter Editor geöffnet ist.

Siehe auch ` openPersistentEditor()` und ` closePersistentEditor()`.

QListWidgetItem *QListWidget::item(int row) const

Gibt das Element zurück, das die angegebene „ row “ in der Liste einnimmt, sofern eine solche festgelegt wurde; andernfalls wird „ nullptr “ zurückgegeben.

Siehe auch row().

[signal] void QListWidget::itemActivated(QListWidgetItem *item)

Dieses Signal wird ausgesendet, wenn das „ item “ aktiviert wird. Das „ item “ wird aktiviert, wenn der Benutzer darauf klickt oder doppelklickt, je nach Systemkonfiguration. Es wird außerdem aktiviert, wenn der Benutzer die Aktivierungstaste drückt (unter Windows und X11 ist dies die Taste „ Return “, unter Mac OS X ist es „ Command+O “).

QListWidgetItem *QListWidget::itemAt(const QPoint &p) const

Gibt einen Zeiger auf das Element an den Koordinaten ` p` zurück. Die Koordinaten beziehen sich auf die ` viewport()` des Listen-Widgets.

QListWidgetItem *QListWidget::itemAt(int x, int y) const

Gibt einen Zeiger auf das Element an den Koordinaten (x, y) zurück. Die Koordinaten beziehen sich auf die Funktion „ viewport()“ des Listen-Widgets.

[signal] void QListWidget::itemChanged(QListWidgetItem *item)

Dieses Signal wird immer dann ausgegeben, wenn sich die Daten von „ item “ geändert haben.

[signal] void QListWidget::itemClicked(QListWidgetItem *item)

Dieses Signal wird mit dem angegebenen item ausgelöst, wenn eine Maustaste auf einem Element im Widget angeklickt wird.

Siehe auch „ itemPressed()“ und „ itemDoubleClicked()“.

[signal] void QListWidget::itemDoubleClicked(QListWidgetItem *item)

Dieses Signal wird mit dem angegebenen item ausgelöst, wenn eine Maustaste auf einem Element im Widget doppelt angeklickt wird.

Siehe auch „ itemClicked()“ und „ itemPressed()“.

[signal] void QListWidget::itemEntered(QListWidgetItem *item)

Dieses Signal wird ausgelöst, wenn der Mauszeiger in ein Element eintritt. „ item “ ist das Element, in das der Mauszeiger eingetreten ist. Dieses Signal wird nur ausgelöst, wenn „mouseTracking“ aktiviert ist oder wenn beim Einfahren in ein Element eine Maustaste gedrückt wird.

Siehe auch ` QWidget::setMouseTracking()`.

QListWidgetItem *QListWidget::itemFromIndex(const QModelIndex &index) const

Gibt einen Zeiger auf den „ QListWidgetItem “ zurück, der mit dem angegebenen „ index “ verknüpft ist.

[signal] void QListWidget::itemPressed(QListWidgetItem *item)

Dieses Signal wird mit dem angegebenen item ausgelöst, wenn eine Maustaste auf einem Element im Widget gedrückt wird.

Siehe auch „ itemClicked()“ und „ itemDoubleClicked()“.

[signal] void QListWidget::itemSelectionChanged()

Dieses Signal wird immer dann ausgelöst, wenn sich die Auswahl ändert.

Siehe auch selectedItems(), QListWidgetItem::isSelected() und currentItemChanged().

QWidget *QListWidget::itemWidget(QListWidgetItem *item) const

Gibt das Widget zurück, das unter der angegebenen Adresse item angezeigt wird.

Siehe auch „ setItemWidget()“ und „ removeItemWidget()“.

QList<QListWidgetItem *> QListWidget::items(const QMimeData *data) const

Gibt eine Liste von Zeigern auf die im Objekt „ data “ enthaltenen Elemente zurück. Wenn das Objekt nicht durch eine „ QListWidget “ im selben Prozess erstellt wurde, ist die Liste leer.

[virtual protected] QMimeData *QListWidget::mimeData(const QList<QListWidgetItem *> &items) const

Gibt ein Objekt zurück, das eine serialisierte Beschreibung der angegebenen ` items` enthält. Das zur Beschreibung der Elemente verwendete Format wird von der Funktion ` mimeTypes()` bereitgestellt.

Ist die Liste der Elemente leer, wird nullptr anstelle einer serialisierten leeren Liste zurückgegeben.

[virtual protected] QStringList QListWidget::mimeTypes() const

Gibt eine Liste von MIME-Typen zurück, mit denen eine Liste von Listwidget-Elementen beschrieben werden kann.

Siehe auch ` mimeData()`.

void QListWidget::openPersistentEditor(QListWidgetItem *item)

Öffnet einen Editor für die angegebene Datei „ item “. Der Editor bleibt nach der Bearbeitung geöffnet.

Siehe auch „ closePersistentEditor()“ und „ isPersistentEditorOpen()“.

void QListWidget::removeItemWidget(QListWidgetItem *item)

Entfernt das Widget-Set mit der angegebenen ID „ item “.

Um ein Element (eine Zeile) vollständig aus der Liste zu entfernen, löschen Sie das Element entweder oder verwenden Sie ` takeItem()`.

Siehe auch itemWidget() und setItemWidget().

int QListWidget::row(const QListWidgetItem *item) const

Gibt die Zeile zurück, die den angegebenen Wert „ item “ enthält.

Siehe auch item().

[slot] void QListWidget::scrollToItem(const QListWidgetItem *item, QAbstractItemView::ScrollHint hint = EnsureVisible)

Blättert die Ansicht bei Bedarf, um sicherzustellen, dass der „ item “ sichtbar ist.

hint Legt fest, wo sich das „ item “ nach dem Vorgang befinden soll.

QList<QListWidgetItem *> QListWidget::selectedItems() const

Gibt eine Liste aller ausgewählten Elemente im Listen-Widget zurück.

void QListWidget::setCurrentItem(QListWidgetItem *item)

Setzt das aktuelle Element auf „ item “.

Sofern der Auswahlmodus nicht „ NoSelection “ ist, wird das Element zusätzlich ausgewählt.

Siehe auch currentItem().

void QListWidget::setCurrentItem(QListWidgetItem *item, QItemSelectionModel::SelectionFlags command)

Setze das aktuelle Element auf „ item “ unter Verwendung der angegebenen „ command “.

void QListWidget::setCurrentRow(int row, QItemSelectionModel::SelectionFlags command)

Setzt die aktuelle Zeile auf den angegebenen Wert ` row` unter Verwendung des angegebenen ` command`,

Siehe auch currentRow().

void QListWidget::setItemWidget(QListWidgetItem *item, QWidget *widget)

Legt fest, dass das „ widget “ an der angegebenen Stelle item angezeigt wird.

Diese Funktion sollte nur verwendet werden, um statische Inhalte anstelle eines List-Widget-Elements anzuzeigen. Wenn Sie benutzerdefinierte dynamische Inhalte anzeigen oder ein benutzerdefiniertes Editor-Widget implementieren möchten, verwenden Sie stattdessen ` QListView ` und erstellen Sie eine Unterklasse von ` QStyledItemDelegate `.

Siehe auch „ itemWidget()“, „ removeItemWidget()“ und „Delegate-Klassen“.

[override virtual] void QListWidget::setSelectionModel(QItemSelectionModel *selectionModel)

Implementiert: QAbstractItemView::setSelectionModel(QItemSelectionModel *selectionModel).

void QListWidget::sortItems(Qt::SortOrder order = Qt::AscendingOrder)

Sortiert alle Elemente im Listen-Widget gemäß dem angegebenen „ order “.

[virtual protected] Qt::DropActions QListWidget::supportedDropActions() const

Gibt die von dieser Ansicht unterstützten Drag-and-Drop-Aktionen zurück.

Siehe auch „ Qt::DropActions“ , „ supportedDragActions “ und „ dropMimeData()“.

QListWidgetItem *QListWidget::takeItem(int row)

Entfernt das Element aus dem angegebenen „ row “ im Listen-Widget und gibt es zurück; andernfalls wird „ nullptr “ zurückgegeben.

Aus einem Listen-Widget entfernte Elemente werden von Qt nicht verwaltet und müssen manuell gelöscht werden.

Siehe auch „ insertItem()“ und „ addItem()“.

QRect QListWidget::visualItemRect(const QListWidgetItem *item) const

Gibt das Rechteck im Ansichtsbereich zurück, das das Element unter item einnimmt.