QListWidgetItem Class

Die Klasse QListWidgetItem bietet ein Element zur Verwendung mit der Ansichtsklasse QListWidget. Mehr...

Kopfzeile: #include <QListWidgetItem>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets

Öffentliche Typen

enum ItemType { Type, UserType }

Öffentliche Funktionen

QListWidgetItem(QListWidget *parent = nullptr, int type = Type)
QListWidgetItem(const QString &text, QListWidget *parent = nullptr, int type = Type)
QListWidgetItem(const QIcon &icon, const QString &text, QListWidget *parent = nullptr, int type = Type)
QListWidgetItem(const QListWidgetItem &other)
virtual ~QListWidgetItem()
QBrush background() const
Qt::CheckState checkState() const
virtual QListWidgetItem *clone() const
virtual QVariant data(int role) const
Qt::ItemFlags flags() const
QFont font() const
QBrush foreground() const
QIcon icon() const
bool isHidden() const
bool isSelected() const
QListWidget *listWidget() const
virtual void read(QDataStream &in)
void setBackground(const QBrush &brush)
void setCheckState(Qt::CheckState state)
virtual void setData(int role, const QVariant &value)
void setFlags(Qt::ItemFlags flags)
void setFont(const QFont &font)
void setForeground(const QBrush &brush)
void setHidden(bool hide)
void setIcon(const QIcon &icon)
void setSelected(bool select)
void setSizeHint(const QSize &size)
void setStatusTip(const QString &statusTip)
void setText(const QString &text)
(since 6.4) void setTextAlignment(Qt::Alignment alignment)
void setToolTip(const QString &toolTip)
void setWhatsThis(const QString &whatsThis)
QSize sizeHint() const
QString statusTip() const
QString text() const
int textAlignment() const
QString toolTip() const
int type() const
QString whatsThis() const
virtual void write(QDataStream &out) const
virtual bool operator<(const QListWidgetItem &other) const
QListWidgetItem &operator=(const QListWidgetItem &other)
QDataStream &operator<<(QDataStream &out, const QListWidgetItem &item)
QDataStream &operator>>(QDataStream &in, QListWidgetItem &item)

Detaillierte Beschreibung

Ein QListWidgetItem repräsentiert ein einzelnes Element in einer QListWidget. Jedes Element kann mehrere Informationen enthalten und zeigt diese entsprechend an.

Die Item-View-Klassen verwenden eine klassische Item-basierte Schnittstelle anstelle eines reinen Model/View-Ansatzes. Für ein flexibleres Listenansichts-Widget sollten Sie die Klasse QListView mit einem Standardmodell verwenden.

Listenelemente können automatisch in eine Liste eingefügt werden, wenn sie erstellt werden, indem das Listen-Widget angegeben wird:

    new QListWidgetItem(tr("Hazel"), listWidget);

Alternativ können Listenelemente auch ohne ein übergeordnetes Widget erstellt und später mit QListWidget::insertItem() in eine Liste eingefügt werden.

Listenelemente werden normalerweise verwendet, um text() und icon() anzuzeigen. Diese werden mit den Funktionen setText() und setIcon() eingestellt. Das Aussehen des Textes kann mit setFont(), setForeground() und setBackground() angepasst werden. Text in Listenelementen kann mit der Funktion setTextAlignment() ausgerichtet werden. Tooltips, Statustipps und "Was ist das?"-Hilfe können mit setToolTip(), setStatusTip() und setWhatsThis() zu Listenelementen hinzugefügt werden.

Standardmäßig sind Elemente aktiviert, auswählbar, abhakbar und können als Quelle für Drag-and-Drop-Operationen dienen.

Die Flags der einzelnen Elemente können durch Aufruf von setFlags() mit dem entsprechenden Wert geändert werden (siehe Qt::ItemFlags). Ankreuzbare Elemente können mit der Funktion setCheckState() angekreuzt, nicht angekreuzt und teilweise angekreuzt werden. Die entsprechende Funktion checkState() zeigt den aktuellen Prüfstatus des Eintrags an.

Die Funktion isHidden() kann verwendet werden, um festzustellen, ob der Eintrag versteckt ist. Um ein Element auszublenden, verwenden Sie setHidden().

Unterklassifizierung

Wenn man QListWidgetItem subclassing, um benutzerdefinierte Elemente bereitzustellen, ist es möglich, neue Typen für sie zu definieren, die es ermöglichen, sie von Standard-Elementen zu unterscheiden. Für Unterklassen, die diese Funktion benötigen, stellen Sie sicher, dass Sie den Konstruktor der Basisklasse mit einem neuen Typwert gleich oder größer als UserType innerhalb Ihres Konstruktors aufrufen.

Siehe auch QListWidget, Model/View Programming, QTreeWidgetItem, und QTableWidgetItem.

Dokumentation der Mitgliedstypen

enum QListWidgetItem::ItemType

Diese Aufzählung beschreibt die Typen, die zur Beschreibung von Listenwidgetelementen verwendet werden.

KonstanteWertBeschreibung
QListWidgetItem::Type0Der Standardtyp für Listenwidgetelemente.
QListWidgetItem::UserType1000Der Mindestwert für benutzerdefinierte Typen. Werte unterhalb von UserType sind von Qt reserviert.

Sie können neue Benutzertypen in QListWidgetItem Unterklassen definieren, um sicherzustellen, dass benutzerdefinierte Elemente speziell behandelt werden.

Siehe auch type().

Dokumentation der Mitgliedsfunktionen

[explicit] QListWidgetItem::QListWidgetItem(QListWidget *parent = nullptr, int type = Type)

Konstruiert ein leeres Listen-Widget-Element des angegebenen type mit dem angegebenen parent. Wenn parent nicht angegeben ist, muss das Element mit QListWidget::insertItem() in ein Listen-Widget eingefügt werden.

Dieser Konstruktor fügt das Element in das Modell des Elternteils ein, das an den Konstruktor übergeben wird. Wenn das Modell sortiert ist, ist das Verhalten des Einfügens unbestimmt, da das Modell die '<' Operator-Methode für das Element aufrufen wird, das zu diesem Zeitpunkt noch nicht konstruiert ist. Um das unbestimmte Verhalten zu vermeiden, empfehlen wir, das Elternteil nicht anzugeben und stattdessen QListWidget::insertItem() zu verwenden.

Siehe auch type().

[explicit] QListWidgetItem::QListWidgetItem(const QString &text, QListWidget *parent = nullptr, int type = Type)

Konstruiert ein leeres Listen-Widget-Element des angegebenen type mit den angegebenen text und parent. Wenn das übergeordnete Element nicht angegeben ist, muss das Element mit QListWidget::insertItem() in ein Listen-Widget eingefügt werden.

Dieser Konstruktor fügt das Element in das Modell des Elternteils ein, das an den Konstruktor übergeben wird. Wenn das Modell sortiert ist, ist das Verhalten des Einfügens unbestimmt, da das Modell die '<' Operator-Methode für das Element aufrufen wird, das zu diesem Zeitpunkt noch nicht konstruiert ist. Um das unbestimmte Verhalten zu vermeiden, empfehlen wir, das Elternteil nicht anzugeben und stattdessen QListWidget::insertItem() zu verwenden.

Siehe auch type().

[explicit] QListWidgetItem::QListWidgetItem(const QIcon &icon, const QString &text, QListWidget *parent = nullptr, int type = Type)

Konstruiert ein leeres Listen-Widget-Element des angegebenen type mit den angegebenen icon, text und parent. Wenn das übergeordnete Element nicht angegeben ist, muss das Element mit QListWidget::insertItem() in ein Listen-Widget eingefügt werden.

Dieser Konstruktor fügt das Element in das Modell des Elternteils ein, das an den Konstruktor übergeben wird. Wenn das Modell sortiert ist, ist das Verhalten des Einfügens unbestimmt, da das Modell die '<' Operator-Methode für das Element aufruft, das zu diesem Zeitpunkt noch nicht konstruiert ist. Um das unbestimmte Verhalten zu vermeiden, empfehlen wir, das Elternteil nicht anzugeben und stattdessen QListWidget::insertItem() zu verwenden.

Siehe auch type().

QListWidgetItem::QListWidgetItem(const QListWidgetItem &other)

Konstruiert eine Kopie von other. Beachten Sie, dass type() und listWidget() nicht kopiert werden.

Diese Funktion ist nützlich bei der Neuimplementierung von clone().

Siehe auch data() und flags().

[virtual noexcept] QListWidgetItem::~QListWidgetItem()

Zerstört das Listenelement.

QBrush QListWidgetItem::background() const

Gibt den Pinsel zurück, mit dem der Hintergrund des Listenelements dargestellt wird.

Siehe auch setBackground() und foreground().

Qt::CheckState QListWidgetItem::checkState() const

Gibt den Status des Listeneintrags zurück (siehe Qt::CheckState).

Siehe auch setCheckState() und flags().

[virtual] QListWidgetItem *QListWidgetItem::clone() const

Erzeugt eine exakte Kopie des Objekts.

[virtual] QVariant QListWidgetItem::data(int role) const

Gibt die Daten des Elements für eine bestimmte role zurück. Implementieren Sie diese Funktion neu, wenn Sie zusätzliche Rollen oder ein spezielles Verhalten für bestimmte Rollen benötigen.

Siehe auch Qt::ItemDataRole und setData().

Qt::ItemFlags QListWidgetItem::flags() const

Gibt die Artikelkennzeichen für diesen Artikel zurück (siehe Qt::ItemFlags).

Siehe auch setFlags().

QFont QListWidgetItem::font() const

Gibt die Schriftart zurück, die für die Anzeige des Textes dieses Listenelements verwendet wird.

Siehe auch setFont().

QBrush QListWidgetItem::foreground() const

Gibt den Pinsel zurück, mit dem der Vordergrund des Listenelements dargestellt wird (z. B. Text).

Siehe auch setForeground() und background().

QIcon QListWidgetItem::icon() const

Gibt das Symbol des Listenelements zurück.

Siehe auch setIcon() und iconSize.

bool QListWidgetItem::isHidden() const

Gibt true zurück, wenn das Element ausgeblendet ist; andernfalls wird false zurückgegeben.

Siehe auch setHidden().

bool QListWidgetItem::isSelected() const

Gibt true zurück, wenn das Element ausgewählt ist; andernfalls wird false zurückgegeben.

Siehe auch setSelected().

QListWidget *QListWidgetItem::listWidget() const

Gibt das Listen-Widget zurück, das das Element enthält.

[virtual] void QListWidgetItem::read(QDataStream &in)

Liest das Element aus dem Stream in.

Siehe auch write().

void QListWidgetItem::setBackground(const QBrush &brush)

Setzt den Hintergrundpinsel des Listenelements auf den angegebenen brush. Wenn Sie einen standardmäßig konstruierten Pinsel einstellen, wird die Ansicht die Standardfarbe des Stils verwenden.

Siehe auch background() und setForeground().

void QListWidgetItem::setCheckState(Qt::CheckState state)

Setzt den Prüfstatus des Listeneintrags auf state.

Siehe auch checkState().

[virtual] void QListWidgetItem::setData(int role, const QVariant &value)

Setzt die Daten für eine gegebene role auf die gegebene value. Implementieren Sie diese Funktion neu, wenn Sie zusätzliche Rollen oder ein spezielles Verhalten für bestimmte Rollen benötigen.

Hinweis: Die Standardimplementierung behandelt Qt::EditRole und Qt::DisplayRole als auf dieselben Daten verweisend.

Siehe auch Qt::ItemDataRole und data().

void QListWidgetItem::setFlags(Qt::ItemFlags flags)

Setzt die Elementflags für das Listenelement auf flags.

Siehe auch flags() und Qt::ItemFlags.

void QListWidgetItem::setFont(const QFont &font)

Setzt die Schriftart, die beim Malen des Elements verwendet wird, auf die angegebene font.

Siehe auch font().

void QListWidgetItem::setForeground(const QBrush &brush)

Setzt den Vordergrundpinsel des Listenelements auf den angegebenen brush. Wenn Sie einen standardmäßig konstruierten Pinsel einstellen, wird die Ansicht die Standardfarbe des Stils verwenden.

Siehe auch foreground() und setBackground().

void QListWidgetItem::setHidden(bool hide)

Blendet das Element aus, wenn hide wahr ist; andernfalls wird das Element angezeigt.

Siehe auch isHidden().

void QListWidgetItem::setIcon(const QIcon &icon)

Setzt das Symbol für das Listenelement auf das angegebene icon.

Siehe auch icon(), text(), und iconSize.

void QListWidgetItem::setSelected(bool select)

Setzt den ausgewählten Status des Elements auf select.

Siehe auch isSelected().

void QListWidgetItem::setSizeHint(const QSize &size)

Legt den Größenhinweis für das Listenelement fest, das size sein soll. Wenn kein Größenhinweis festgelegt oder size ungültig ist, berechnet der Elementdelegierte den Größenhinweis auf der Grundlage der Elementdaten.

Siehe auch sizeHint().

void QListWidgetItem::setStatusTip(const QString &statusTip)

Setzt den Statustipp für das Listenelement auf den in statusTip angegebenen Text. QListWidget mouseTracking muss aktiviert sein, damit diese Funktion funktioniert.

Siehe auch statusTip(), setToolTip(), setWhatsThis(), und QWidget::setMouseTracking().

void QListWidgetItem::setText(const QString &text)

Setzt den Text für die Elemente des Listen-Widgets auf den angegebenen text.

Siehe auch text().

[since 6.4] void QListWidgetItem::setTextAlignment(Qt::Alignment alignment)

Setzt die Textausrichtung des Listenelements auf alignment.

Diese Funktion wurde in Qt 6.4 eingeführt.

Siehe auch textAlignment().

void QListWidgetItem::setToolTip(const QString &toolTip)

Setzt den Tooltip für das Listenelement auf den in toolTip angegebenen Text.

Siehe auch toolTip(), setStatusTip(), und setWhatsThis().

void QListWidgetItem::setWhatsThis(const QString &whatsThis)

Setzt die "What's This?"-Hilfe für den Listeneintrag auf den durch whatsThis angegebenen Text.

Siehe auch whatsThis(), setStatusTip(), und setToolTip().

QSize QListWidgetItem::sizeHint() const

Gibt den Größenhinweis zurück, der für das Listenelement festgelegt wurde.

Siehe auch setSizeHint().

QString QListWidgetItem::statusTip() const

Gibt den Statustipp des Listenelements zurück.

Siehe auch setStatusTip().

QString QListWidgetItem::text() const

Gibt den Text des Listeneintrags zurück.

Siehe auch setText().

int QListWidgetItem::textAlignment() const

Gibt die Textausrichtung für das Listenelement zurück.

Hinweis: Diese Funktion gibt aus historischen Gründen einen int zurück. In Qt 7 wird sie korrigiert und gibt Qt::Alignment zurück.

Siehe auch setTextAlignment() und Qt::Alignment.

QString QListWidgetItem::toolTip() const

Gibt den Tooltip des Listenelements zurück.

Siehe auch setToolTip(), statusTip(), und whatsThis().

int QListWidgetItem::type() const

Gibt den Typ zurück, der an den QListWidgetItem Konstruktor übergeben wurde.

QString QListWidgetItem::whatsThis() const

Gibt den "Was ist das?"-Hilfetext des Listenelements zurück.

Siehe auch setWhatsThis(), statusTip(), und toolTip().

[virtual] void QListWidgetItem::write(QDataStream &out) const

Schreibt das Element in den Stream out.

Siehe auch read().

[virtual] bool QListWidgetItem::operator<(const QListWidgetItem &other) const

Gibt true zurück, wenn der Text dieses Elements kleiner ist als der Text des Elements other; andernfalls wird false zurückgegeben.

QListWidgetItem &QListWidgetItem::operator=(const QListWidgetItem &other)

Weist die Daten und Flaggen von other diesem Element zu. Beachten Sie, dass type() und listWidget() nicht kopiert werden.

Diese Funktion ist nützlich bei der Neuimplementierung von clone().

Siehe auch data() und flags().

Verwandte Nicht-Mitglieder

QDataStream &operator<<(QDataStream &out, const QListWidgetItem &item)

Schreibt das Listen-Widget-Element item in den Stream out.

Dieser Operator verwendet QListWidgetItem::write().

Siehe auch Serialisierung von Qt-Datentypen.

QDataStream &operator>>(QDataStream &in, QListWidgetItem &item)

Liest ein Listen-Widget-Element aus dem Stream in in item.

Dieser Operator verwendet QListWidgetItem::read().

Siehe auch Serialisierung von Qt-Datentypen.

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.