QTableWidgetItem Class
Die Klasse „QTableWidgetItem“ stellt ein Element zur Verwendung mit der Klasse „ QTableWidget “ bereit. Mehr...
| Header: | #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) |
Verwandte Nicht-Mitglieder
| QDataStream & | operator<<(QDataStream &out, const QTableWidgetItem &item) |
| QDataStream & | operator>>(QDataStream &in, QTableWidgetItem &item) |
Ausführliche Beschreibung
Tabellenelemente dienen dazu, Informationen für Tabellen-Widgets zu speichern. Elemente enthalten in der Regel Text, Symbole oder Kontrollkästchen
Die Klasse `QTableWidgetItem` ist eine Komfortklasse, die in Qt 3 die Klasse ` QTableItem ` ersetzt. Sie stellt ein Element zur Verwendung mit der Klasse ` QTableWidget ` bereit.
Elemente der obersten Ebene werden ohne übergeordnetes Element erstellt und dann an der durch ein Paar aus Zeilen- und Spaltennummern angegebenen Position eingefügt:
QTableWidgetItem *newItem = new QTableWidgetItem(tr("%1").arg(
pow(row, column+1)));
tableWidget->setItem(row, column, newItem);Jedes Element kann einen eigenen Hintergrundpinsel haben, der mit der Funktion ` setBackground()` festgelegt wird. Der aktuelle Hintergrundpinsel kann mit ` background()` abgerufen werden. Die Textbeschriftung für jedes Element kann mit einer eigenen Schriftart und einem eigenen Pinsel dargestellt werden. Diese werden mit den Funktionen ` setFont()` und ` setForeground()` festgelegt und mit ` font()` und ` foreground()` ausgelesen.
Standardmäßig sind Elemente aktiviert, bearbeitbar, auswählbar, markierbar und können sowohl als Quelle für eine Drag-and-Drop-Operation als auch als Ziel für das Ablegen verwendet werden. Die Flags jedes Elements können durch Aufruf von ` setFlags()` mit dem entsprechenden Wert geändert werden (siehe ` Qt::ItemFlags`). Aktivierbare Elemente können mit der Funktion „ setCheckState “ () aktiviert und deaktiviert werden. Die entsprechende Funktion „ checkState “ () gibt an, ob das Element derzeit aktiviert ist.
Unterklassen
Bei der Unterklassifizierung von `QTableWidgetItem` zur Bereitstellung benutzerdefinierter Elemente ist es möglich, neue Typen für diese zu definieren, damit sie von Standardelementen unterschieden werden können. Die Konstruktoren für Unterklassen, die diese Funktion benötigen, müssen den Konstruktor der Basisklasse mit einem neuen Typwert aufrufen, der gleich oder größer als ` UserType` ist.
Siehe auch QTableWidget, Modell-/Ansichtsprogrammierung, QListWidgetItem und QTreeWidgetItem.
Dokumentation zu Mitgliedstypen
enum QTableWidgetItem::ItemType
Diese Enumeration beschreibt die Typen, die zur Beschreibung von Elementen des Tabellen-Widgets verwendet werden.
| Konstante | Wert | Beschreibung |
|---|---|---|
QTableWidgetItem::Type | 0 | Der Standardtyp für Elemente des Tabellen-Widgets. |
QTableWidgetItem::UserType | 1000 | Der Mindestwert für benutzerdefinierte Typen. Werte unterhalb von „UserType“ sind von Qt reserviert. |
Sie können neue Benutzertypen in Unterklassen von ` QTableWidgetItem ` definieren, um sicherzustellen, dass benutzerdefinierte Elemente besonders behandelt werden.
Siehe auch „ type()“.
Dokumentation zu den Mitgliedsfunktionen
[explicit] QTableWidgetItem::QTableWidgetItem(int type = Type)
Erstellt ein Tabellenelement des angegebenen type, das zu keiner Tabelle gehört.
Siehe auch ` type()`.
[explicit] QTableWidgetItem::QTableWidgetItem(const QString &text, int type = Type)
Erstellt ein Tabellenelement mit dem angegebenen ` text`.
Siehe auch ` type()`.
[explicit] QTableWidgetItem::QTableWidgetItem(const QIcon &icon, const QString &text, int type = Type)
Erstellt ein Tabellenelement mit den angegebenen Werten für ` icon ` und ` text`.
Siehe auch type().
QTableWidgetItem::QTableWidgetItem(const QTableWidgetItem &other)
Erstellt eine Kopie von ` other`. Beachten Sie, dass ` type()` und ` tableWidget()` nicht kopiert werden.
Diese Funktion ist nützlich, wenn „ clone()“ neu implementiert wird.
Siehe auch data() und flags().
[virtual noexcept] QTableWidgetItem::~QTableWidgetItem()
Löscht das Tabellenelement.
QBrush QTableWidgetItem::background() const
Gibt den Pinsel zurück, der zum Rendern des Hintergrunds des Elements verwendet wurde.
Siehe auch setBackground() und foreground().
Qt::CheckState QTableWidgetItem::checkState() const
Gibt den Markierungsstatus des Tabellenelements zurück.
Siehe auch setCheckState() und flags().
[virtual] QTableWidgetItem *QTableWidgetItem::clone() const
Erstellt eine Kopie des Elements.
int QTableWidgetItem::column() const
Gibt die Spalte des Elements in der Tabelle zurück. Befindet sich das Element 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 Elements verwendet werden. Diese legen fest, ob das Element angekreuzt, bearbeitet und ausgewählt werden kann.
Siehe auch „ setFlags()“.
QFont QTableWidgetItem::font() const
Gibt die Schriftart zurück, die zum Darstellen des Texts des Elements verwendet wird.
Siehe auch „ setFont()“.
QBrush QTableWidgetItem::foreground() const
Gibt den Pinsel zurück, der zum Rendern des Vordergrunds des Elements (z. B. Text) verwendet wurde.
Siehe auch setForeground() und background().
QIcon QTableWidgetItem::icon() const
Gibt das Symbol des Elements 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 Elements in der Tabelle zurück. Befindet sich das Element 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 Pinsel brush. Durch das Festlegen eines standardmäßig konstruierten Pinsels verwendet die Ansicht die Standardfarbe aus dem Stil.
Siehe auch „ background()“ und „ setForeground()“.
void QTableWidgetItem::setCheckState(Qt::CheckState state)
Setzt den Markierungsstatus des Tabellenelements auf „ state “.
Siehe auch ` checkState()`.
[virtual] void QTableWidgetItem::setData(int role, const QVariant &value)
Setzt die Daten des Elements für die angegebene Adresse role auf die angegebene Adresse value.
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 QTableWidgetItem::setFlags(Qt::ItemFlags flags)
Setzt die Flags für das Element auf die angegebenen Werte flags. Diese legen fest, ob das Element ausgewählt oder geändert werden kann.
Siehe auch flags().
void QTableWidgetItem::setFont(const QFont &font)
Legt die Schriftart fest, die zur Anzeige des Textes des Elements verwendet wird, und zwar die angegebene „ font “.
Siehe auch font(), setText() und setForeground().
void QTableWidgetItem::setForeground(const QBrush &brush)
Legt den Vordergrundpinsel des Elements auf den angegebenen „ brush “ fest. Durch das Festlegen eines standardmäßig erstellten Pinsels verwendet die Ansicht die Standardfarbe aus dem Stil.
Siehe auch „ foreground()“ und „ setBackground()“.
void QTableWidgetItem::setIcon(const QIcon &icon)
Setzt das Symbol des Elements auf die angegebene URL 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)
Legt den Größenhinweis für das Tabellenelement 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 QTableWidgetItem::setStatusTip(const QString &statusTip)
Setzt den Status-Tooltip für das Tabellenelement auf den unter statusTip angegebenen Text. QTableWidget Damit diese Funktion genutzt werden kann, muss die Mausverfolgung aktiviert sein.
Siehe auch statusTip(), setToolTip() und setWhatsThis().
void QTableWidgetItem::setText(const QString &text)
Setzt den Text des Elements auf die angegebene URL text.
Siehe auch „ text()“, „ setFont()“ und „ setForeground()“.
[since 6.4] void QTableWidgetItem::setTextAlignment(Qt::Alignment alignment)
Legt die Textausrichtung für den Text des Elements auf den angegebenen Wert „ alignment “ fest.
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 Zeichenfolge.
Siehe auch „ toolTip()“, „ setStatusTip()“ und „ setWhatsThis()“.
void QTableWidgetItem::setWhatsThis(const QString &whatsThis)
Setzt die „Was ist das?“-Hilfe des Elements auf die Zeichenkette, die unter whatsThis angegeben ist.
Siehe auch whatsThis(), setStatusTip() und setToolTip().
QSize QTableWidgetItem::sizeHint() const
Gibt den für das Tabellenelement festgelegten 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 Elements zurück.
Siehe auch „ setText()“.
int QTableWidgetItem::textAlignment() const
Gibt die Textausrichtung für den Text des Elements zurück.
Hinweis: Aus historischen Gründen gibtdiese Funktion einen int-Wert zurück. In Qt 7 wird dies korrigiert, sodass die Funktion „ Qt::Alignment “ zurückgibt.
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 an den Konstruktor „ QTableWidgetItem “ übergebenen Typ zurück.
QString QTableWidgetItem::whatsThis() const
Gibt die Hilfe „Was ist das?“ zum Element 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 der Wert kleiner ist als der Wert „ other “; andernfalls wird „false“ zurückgegeben.
QTableWidgetItem &QTableWidgetItem::operator=(const QTableWidgetItem &other)
Weist diesem Element die Daten und Flags von ` other` zu. Beachten Sie, dass ` type()` und ` tableWidget()` nicht kopiert werden.
Diese Funktion ist nützlich, wenn Sie ` clone()` neu implementieren.
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 vonQt-Datentypen“.
QDataStream &operator>>(QDataStream &in, QTableWidgetItem &item)
Liest ein Tabellen-Widget-Element aus dem Stream „ in “ in „ item “ ein.
Dieser Operator verwendet ` QTableWidgetItem::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.