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) |
Verwandte Nicht-Mitglieder
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.
Konstante | Wert | Beschreibung |
---|---|---|
QTableWidgetItem::Type | 0 | Der Standardtyp für Tabellen-Widget-Elemente. |
QTableWidgetItem::UserType | 1000 | Der 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().
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.