Auf dieser Seite

QListWidgetItem Class

Die Klasse „QListWidgetItem“ stellt ein Element zur Verwendung mit der Elementansichtsklasse „ QListWidget “ bereit. Mehr...

Header: #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)

Ausführliche Beschreibung

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

Die Komfortklassen für die Elementansicht verwenden eine klassische, elementbasierte Schnittstelle anstelle eines reinen Modell-Darstellungs-Ansatzes. Für ein flexibleres Listenansichts-Widget sollten Sie die Verwendung der Klasse „ QListView “ mit einem Standardmodell in Betracht ziehen.

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

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

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

Listenelemente werden typischerweise zur Anzeige von ` text()` und ` icon()` verwendet. Diese werden mit den Funktionen ` setText()` und ` setIcon()` festgelegt. Das Erscheinungsbild des Texts kann mit ` setFont()`, ` setForeground()` und ` setBackground()` angepasst werden. Der Text in Listenelementen kann mithilfe der Funktion ` setTextAlignment()` ausgerichtet werden. Tooltips, Statushinweise und die „Was ist das?“-Hilfe können mit den Funktionen „ setToolTip()“, „ setStatusTip()“ und „ setWhatsThis()“ zu Listenelementen hinzugefügt werden.

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

Die Flags jedes Elements können durch Aufruf von ` setFlags()` mit dem entsprechenden Wert geändert werden (siehe Qt::ItemFlags). Markierbare Elemente können mit der Funktion ` setCheckState()` markiert, die Markierung aufgehoben oder teilweise markiert werden. Die entsprechende Funktion ` checkState()` gibt den aktuellen Markierungsstatus des Elements an.

Mit der Funktion „ isHidden()“ lässt sich feststellen, ob das Element ausgeblendet ist. Um ein Element auszublenden, verwenden Sie „ setHidden()“.

Unterklassenbildung

Bei der Unterklassenbildung von `QListWidgetItem` zur Bereitstellung benutzerdefinierter Elemente ist es möglich, neue Typen für diese zu definieren, um sie von Standardelementen unterscheiden zu können. Stellen Sie bei Unterklassen, die diese Funktion benötigen, sicher, dass Sie innerhalb Ihres Konstruktors den Konstruktor der Basisklasse mit einem neuen Typwert aufrufen, der gleich oder größer als ` UserType` ist.

Siehe auch QListWidget, Modell-View-Programmierung, QTreeWidgetItem und QTableWidgetItem.

Dokumentation zu Mitgliedstypen

enum QListWidgetItem::ItemType

Diese Enumeration beschreibt die Typen, die zur Beschreibung der Elemente eines Listen-Widgets verwendet werden.

KonstanteWertBeschreibung
QListWidgetItem::Type0Der Standardtyp für Elemente von Listen-Widgets.
QListWidgetItem::UserType1000Der Mindestwert für benutzerdefinierte Typen. Werte unterhalb von `UserType` sind von Qt reserviert.

Sie können neue Benutzertypen in Unterklassen von „ QListWidgetItem “ definieren, um sicherzustellen, dass benutzerdefinierte Elemente besonders behandelt werden.

Siehe auch ` type()`.

Dokumentation zu den Mitgliedsfunktionen

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

Erstellt 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 über den Konstruktor übergebenen übergeordneten Elements ein. Ist das Modell sortiert, ist das Verhalten beim Einfügen unbestimmt, da das Modell die Operator-Methode ` '<' ` für das Element aufruft, das zu diesem Zeitpunkt noch nicht erstellt ist. Um dieses unbestimmte Verhalten zu vermeiden, empfehlen wir, kein übergeordnetes Element anzugeben und stattdessen ` QListWidget::insertItem()` zu verwenden.

Siehe auch ` type()`.

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

Erstellt ein leeres Listen-Widget-Element des angegebenen „ type “ mit den angegebenen Werten „ text “ und „ parent “. Wenn kein übergeordnetes Element 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 übergebenen übergeordneten Elements ein. Ist das Modell sortiert, ist das Verhalten beim Einfügen unbestimmt, da das Modell die Operator-Methode ` '<' ` für das Element aufruft, das zu diesem Zeitpunkt noch nicht erstellt ist. Um dieses unbestimmte Verhalten zu vermeiden, empfehlen wir, das übergeordnete Element 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)

Erstellt ein leeres Listen-Widget-Element des angegebenen „ type “ mit den übergebenen Werten für „ icon “, „ text “ und „ parent “. Wenn kein übergeordnetes Element 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 über den Konstruktor übergebenen übergeordneten Elements ein. Ist das Modell sortiert, ist das Verhalten beim Einfügen unbestimmt, da das Modell die Operator-Methode ` '<' ` für das Element aufruft, das zu diesem Zeitpunkt noch nicht konstruiert ist. Um dieses unbestimmte Verhalten zu vermeiden, empfehlen wir, das übergeordnete Element nicht anzugeben und stattdessen ` QListWidget::insertItem()` zu verwenden.

Siehe auch ` type()`.

QListWidgetItem::QListWidgetItem(const QListWidgetItem &other)

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

Diese Funktion ist nützlich, wenn Sie ` clone()` neu implementieren.

Siehe auch data() und flags().

[virtual noexcept] QListWidgetItem::~QListWidgetItem()

Löscht den Listenpunkt.

QBrush QListWidgetItem::background() const

Gibt den Pinsel zurück, der zur Darstellung des Hintergrunds des Listenelements verwendet wird.

Siehe auch „ setBackground()“ und „ foreground()“.

Qt::CheckState QListWidgetItem::checkState() const

Gibt den Markierungsstatus des Listenelements zurück (siehe Qt::CheckState).

Siehe auch setCheckState() und flags().

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

Erstellt eine exakte Kopie des Elements.

[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 Elementflags für dieses Element zurück (siehe Qt::ItemFlags).

Siehe auch setFlags().

QFont QListWidgetItem::font() const

Gibt die Schriftart zurück, die zur Darstellung des Textes dieses Listenelements verwendet wird.

Siehe auch „ setFont()“.

QBrush QListWidgetItem::foreground() const

Gibt den Pinsel zurück, der zur Darstellung des Vordergrunds des Listenelements (z. B. Text) verwendet wird.

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. Durch das Festlegen eines Pinsels mit Standardkonstruktion verwendet die Ansicht die Standardfarbe aus dem Stil.

Siehe auch „ background()“ und „ setForeground()“.

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

Setzt den Markierungsstatus des Listenelements auf „ state “.

Siehe auch „ checkState()“.

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

Setzt die Daten für eine bestimmte „ role “ auf die angegebene „ value “ zurück. 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 ` so, als würden sie sich auf dieselben Daten beziehen.

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)

Legt die Schriftart fest, die beim Zeichnen des Elements verwendet wird, und zwar auf die angegebene „ font “.

Siehe auch font().

void QListWidgetItem::setForeground(const QBrush &brush)

Setzt den Vordergrundpinsel des Listenelements auf den angegebenen „ brush “. Durch das Festlegen eines standardmäßig konstruierten Pinsels verwendet die Ansicht die Standardfarbe aus dem Stil.

Siehe auch „ foreground()“ und „ setBackground()“.

void QListWidgetItem::setHidden(bool hide)

Blendet das Element aus, wenn „ hide “ auf „true“ gesetzt ist; andernfalls wird das Element angezeigt.

Siehe auch „ isHidden()“.

void QListWidgetItem::setIcon(const QIcon &icon)

Setzt das Symbol für das Listenelement auf die angegebene Adresse 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 auf „ size “ fest. Wenn kein Größenhinweis festgelegt ist oder „ size “ ungültig ist, berechnet der Element-Delegat den Größenhinweis auf der Grundlage der Elementdaten.

Siehe auch „ sizeHint()“.

void QListWidgetItem::setStatusTip(const QString &statusTip)

Setzt den Status-Hinweis für das Listenelement auf den unter statusTip angegebenen Text. QListWidget Damit diese Funktion genutzt werden kann, muss „mouseTracking“ aktiviert sein.

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

void QListWidgetItem::setText(const QString &text)

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

Siehe auch ` text()`.

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

Legt die Textausrichtung des Listenelements auf „ alignment “ fest.

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 Text, der unter toolTip angegeben ist.

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

void QListWidgetItem::setWhatsThis(const QString &whatsThis)

Setzt die „Was ist das?“-Hilfe für das Listenelement auf den unter whatsThis angegebenen Text.

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

QSize QListWidgetItem::sizeHint() const

Gibt den für das Listenelement festgelegten Größenhinweis zurück.

Siehe auch „ setSizeHint()“.

QString QListWidgetItem::statusTip() const

Gibt den Status-Hinweis des Listenelements zurück.

Siehe auch „ setStatusTip()“.

QString QListWidgetItem::text() const

Gibt den Text des Listenelements zurück.

Siehe auch „ setText()“.

int QListWidgetItem::textAlignment() const

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

Hinweis: Aus historischen Gründen gibtdiese Funktion einen ganzzahligen Wert zurück. In Qt 7 wird dies korrigiert, sodass die Funktion „ Qt::Alignment “ zurückgibt.

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 an den Konstruktor „ QListWidgetItem “ übergebenen Typ zurück.

QString QListWidgetItem::whatsThis() const

Gibt den Hilfetext „Was ist das?“ 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 diesem Element die Daten und Flags von ` other` zu. Beachten Sie, dass ` type()` und ` listWidget()` nicht kopiert werden.

Diese Funktion ist nützlich, wenn Sie ` clone()` neu implementieren.

Siehe auch „ data()“ und „ flags()“.

Verwandte Nicht-Mitglieder

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

Schreibt das Element des Listen-Widgets „ item “ in den Stream „ out “.

Dieser Operator verwendet QListWidgetItem::write().

Siehe auch „Serialisierung vonQt-Datentypen“.

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

Liest ein Element des Listen-Widgets aus dem Stream „ in “ in „ item “ ein.

Dieser Operator verwendet ` QListWidgetItem::read()`.

Siehe auch „Serialisierung vonQt-Datentypen“.

© 2026 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.