QTableWidgetItem Class

Die Klasse QTableWidgetItem bietet ein Element zur Verwendung mit der Klasse QTableWidget. Mehr...

Kopfzeile: #include <QTableWidgetItem>
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

QTableWidgetItem(int type = Type)
QTableWidgetItem(const QString &text, int type = Type)
QTableWidgetItem(const QIcon &icon, const QString &text, int type = Type)
QTableWidgetItem(const QTableWidgetItem &other)
virtual ~QTableWidgetItem()
QBrush background() const
Qt::CheckState checkState() const
virtual QTableWidgetItem *clone() const
int column() const
virtual QVariant data(int role) const
Qt::ItemFlags flags() const
QFont font() const
QBrush foreground() const
QIcon icon() const
bool isSelected() const
virtual void read(QDataStream &in)
int row() const
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 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
QTableWidget *tableWidget() 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 QTableWidgetItem &other) const
QTableWidgetItem &operator=(const QTableWidgetItem &other)
QDataStream &operator<<(QDataStream &out, const QTableWidgetItem &item)
QDataStream &operator>>(QDataStream &in, QTableWidgetItem &item)

Detaillierte Beschreibung

Tabellenelemente werden verwendet, um Informationen für Tabellen-Widgets zu speichern. Elemente enthalten normalerweise Text, Icons oder Checkboxen.

Die Klasse QTableWidgetItem ist eine Komfortklasse, die die Klasse QTableItem in Qt 3 ersetzt. Sie bietet ein Element zur Verwendung mit der Klasse QTableWidget.

Top-Level-Elemente werden ohne ein Elternteil konstruiert und dann an der Position eingefügt, die durch ein Paar von Zeilen- und Spaltennummern angegeben wird:

    QTableWidgetItem *newItem = new QTableWidgetItem(tr("%1").arg(
        pow(row, column+1)));
    tableWidget->setItem(row, column, newItem);

Jedes Element kann seinen eigenen Hintergrundpinsel haben, der mit der Funktion setBackground() gesetzt wird. Der aktuelle Hintergrundpinsel kann mit background() ermittelt werden. Die Textbeschriftung für jeden Eintrag kann mit einer eigenen Schriftart und einem eigenen Pinsel gerendert werden. Diese werden mit den Funktionen setFont() und setForeground() festgelegt und mit font() und foreground() ausgelesen.

Standardmäßig sind Elemente aktiviert, bearbeitbar, auswählbar, überprüfbar und können sowohl als Quelle für eine Drag&Drop-Operation als auch als Ablageziel verwendet werden. 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() an- und abgehakt werden. Die entsprechende Funktion checkState() zeigt an, ob das Element derzeit geprüft ist.

Unterklassifizierung

Wenn man QTableWidgetItem subclassing, um benutzerdefinierte Elemente bereitzustellen, ist es möglich, neue Typen für sie zu definieren, so dass sie von Standard-Elementen unterschieden werden können. Die Konstruktoren von Unterklassen, die diese Funktion benötigen, müssen den Konstruktor der Basisklasse mit einem neuen Typwert gleich oder größer als UserType aufrufen.

Siehe auch QTableWidget, Model/View Programming, QListWidgetItem und QTreeWidgetItem.

Dokumentation der Mitgliedstypen

enum QTableWidgetItem::ItemType

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

KonstanteWertBeschreibung
QTableWidgetItem::Type0Der Standardtyp für Tabellen-Widget-Elemente.
QTableWidgetItem::UserType1000Der Mindestwert für benutzerdefinierte Typen. Werte unterhalb von UserType sind von Qt reserviert.

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

Siehe auch type().

Dokumentation der Mitgliedsfunktionen

[explicit] QTableWidgetItem::QTableWidgetItem(int type = Type)

Konstruiert ein Tabellenelement der angegebenen type, das zu keiner Tabelle gehört.

Siehe auch type().

[explicit] QTableWidgetItem::QTableWidgetItem(const QString &text, int type = Type)

Konstruiert ein Tabellenelement mit dem angegebenen text.

Siehe auch type().

[explicit] QTableWidgetItem::QTableWidgetItem(const QIcon &icon, const QString &text, int type = Type)

Konstruiert ein Tabellenelement mit den angegebenen icon und text.

Siehe auch type().

QTableWidgetItem::QTableWidgetItem(const QTableWidgetItem &other)

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

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

Siehe auch data() und flags().

[virtual noexcept] QTableWidgetItem::~QTableWidgetItem()

Zerstört das Tabellenelement.

QBrush QTableWidgetItem::background() const

Gibt den Pinsel zurück, mit dem der Hintergrund des Objekts gerendert wurde.

Siehe auch setBackground() und foreground().

Qt::CheckState QTableWidgetItem::checkState() const

Gibt den überprüften Zustand des Tabellenelements zurück.

Siehe auch setCheckState() und flags().

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

Erzeugt eine Kopie des Objekts.

int QTableWidgetItem::column() const

Gibt die Spalte des Eintrags in der Tabelle zurück. Befindet sich der Eintrag nicht in einer Tabelle, gibt diese Funktion -1 zurück.

Siehe auch row().

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

Gibt die Daten des Elements für die angegebene role zurück.

Siehe auch setData().

Qt::ItemFlags QTableWidgetItem::flags() const

Gibt die Flags zurück, die zur Beschreibung des Eintrags verwendet werden. Diese bestimmen, ob das Element geprüft, bearbeitet und ausgewählt werden kann.

Siehe auch setFlags().

QFont QTableWidgetItem::font() const

Gibt die Schriftart zurück, die für die Darstellung des Textes des Elements verwendet wird.

Siehe auch setFont().

QBrush QTableWidgetItem::foreground() const

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

Siehe auch setForeground() und background().

QIcon QTableWidgetItem::icon() const

Gibt das Symbol des Objekts zurück.

Siehe auch setIcon() und iconSize.

bool QTableWidgetItem::isSelected() const

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

Siehe auch setSelected().

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

Liest das Element aus dem Stream in.

Siehe auch write().

int QTableWidgetItem::row() const

Gibt die Zeile des Eintrags in der Tabelle zurück. Befindet sich der Eintrag nicht in einer Tabelle, gibt diese Funktion -1 zurück.

Siehe auch column().

void QTableWidgetItem::setBackground(const QBrush &brush)

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

Siehe auch background() und setForeground().

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

Setzt den Prüfstatus des Tabelleneintrags auf state.

Siehe auch checkState().

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

Setzt die Daten des Elements für den angegebenen role auf den angegebenen value.

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

Siehe auch Qt::ItemDataRole und data().

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

Setzt die Flags für das Element auf die angegebene flags. Diese bestimmen, ob das Element ausgewählt oder geändert werden kann.

Siehe auch flags().

void QTableWidgetItem::setFont(const QFont &font)

Setzt die Schriftart, die für die Anzeige des Textes des Artikels verwendet wird, auf die angegebene font.

Siehe auch font(), setText(), und setForeground().

void QTableWidgetItem::setForeground(const QBrush &brush)

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

Siehe auch foreground() und setBackground().

void QTableWidgetItem::setIcon(const QIcon &icon)

Setzt das Symbol des Eintrags auf die angegebene icon.

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

void QTableWidgetItem::setSelected(bool select)

Setzt den ausgewählten Status des Elements auf select.

Siehe auch isSelected().

void QTableWidgetItem::setSizeHint(const QSize &size)

Setzt den Größenhinweis für das Tabellenelement auf size. Wenn kein Größenhinweis gesetzt ist oder size ungültig ist, berechnet der Elementdelegierte den Größenhinweis auf der Grundlage der Elementdaten.

Siehe auch sizeHint().

void QTableWidgetItem::setStatusTip(const QString &statusTip)

Setzt den Statustipp für das Tabellenelement auf den durch statusTip angegebenen Text. QTableWidget Die Mausverfolgung muss aktiviert sein, damit diese Funktion funktioniert.

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

void QTableWidgetItem::setText(const QString &text)

Setzt den Text des Eintrags auf den angegebenen text.

Siehe auch text(), setFont(), und setForeground().

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

Setzt die Textausrichtung für den Text des Elements auf die angegebene alignment.

Diese Funktion wurde in Qt 6.4 eingeführt.

Siehe auch textAlignment().

void QTableWidgetItem::setToolTip(const QString &toolTip)

Setzt den Tooltip des Elements auf die durch toolTip angegebene Zeichenkette.

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

void QTableWidgetItem::setWhatsThis(const QString &whatsThis)

Setzt die "Was ist das?"-Hilfe des Elements auf die durch whatsThis angegebene Zeichenkette.

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

QSize QTableWidgetItem::sizeHint() const

Gibt den für das Tabellenelement eingestellten Größenhinweis zurück.

Siehe auch setSizeHint().

QString QTableWidgetItem::statusTip() const

Gibt den Status-Hinweis des Elements zurück.

Siehe auch setStatusTip().

QTableWidget *QTableWidgetItem::tableWidget() const

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

QString QTableWidgetItem::text() const

Gibt den Text des Artikels zurück.

Siehe auch setText().

int QTableWidgetItem::textAlignment() const

Gibt die Textausrichtung für den Text des Elements zurück.

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

Siehe auch setTextAlignment() und Qt::Alignment.

QString QTableWidgetItem::toolTip() const

Gibt den Tooltip des Elements zurück.

Siehe auch setToolTip().

int QTableWidgetItem::type() const

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

QString QTableWidgetItem::whatsThis() const

Gibt die "Was ist das?"-Hilfe des Artikels zurück.

Siehe auch setWhatsThis().

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

Schreibt das Element in den Stream out.

Siehe auch read().

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

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

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

Weist die Daten und Flaggen von other diesem Element zu. Beachten Sie, dass type() und tableWidget() 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 QTableWidgetItem &item)

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

Dieser Operator verwendet QTableWidgetItem::write().

Siehe auch Serialisierung von Qt-Datentypen.

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

Liest ein Tabellen-Widget-Element aus Stream in in item.

Dieser Operator verwendet QTableWidgetItem::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.