QTableWidget Class

Dokumentation der Mitgliedsfunktionen

[explicit] QTableWidget::QTableWidget(QWidget *parent = nullptr)

Erstellt eine neue Tabellenansicht mit der angegebenen „ parent “.

QTableWidget::QTableWidget(int rows, int columns, QWidget *parent = nullptr)

Erstellt eine neue Tabellenansicht mit den angegebenen Werten für „ rows “ und „ columns “ sowie mit dem angegebenen Wert für „ parent “.

[virtual noexcept] QTableWidget::~QTableWidget()

Löscht diese Seite: QTableWidget.

[signal] void QTableWidget::cellActivated(int row, int column)

Dieses Signal wird ausgelöst, wenn die durch „ row “ und „ column “ angegebene Zelle aktiviert wurde.

[signal] void QTableWidget::cellChanged(int row, int column)

Dieses Signal wird immer dann ausgelöst, wenn sich die Daten des Elements in der Zelle, die durch „ row “ und „ column “ angegeben wird, geändert haben.

[signal] void QTableWidget::cellClicked(int row, int column)

Dieses Signal wird ausgelöst, sobald auf eine Zelle in der Tabelle geklickt wird. Die angegebenen Parameter ` row ` und ` column ` beziehen sich auf die Zelle, auf die geklickt wurde.

[signal] void QTableWidget::cellDoubleClicked(int row, int column)

Dieses Signal wird immer dann ausgelöst, wenn auf eine Zelle in der Tabelle doppelgeklickt wird. Die angegebenen Parameter „ row “ und „ column “ beziehen sich auf die Zelle, auf die doppelt geklickt wurde.

[signal] void QTableWidget::cellEntered(int row, int column)

Dieses Signal wird ausgelöst, wenn der Mauszeiger in eine Zelle gelangt. Die Zelle wird durch „ row “ und „ column “ festgelegt.

Dieses Signal wird nur ausgelöst, wenn „mouseTracking“ aktiviert ist oder wenn eine Maustaste gedrückt wird, während der Mauszeiger in ein Element hineinbewegt wird.

[signal] void QTableWidget::cellPressed(int row, int column)

Dieses Signal wird ausgelöst, sobald eine Zelle in der Tabelle angeklickt wird. Die angegebenen Parameter „ row “ und „ column “ beziehen sich auf die Zelle, die angeklickt wurde.

QWidget *QTableWidget::cellWidget(int row, int column) const

Gibt das Widget zurück, das in der Zelle unter den angegebenen Koordinaten ` row ` und ` column` angezeigt wird.

Siehe auch ` setCellWidget()`.

[slot] void QTableWidget::clear()

Entfernt alle Elemente aus der Ansicht. Dabei werden auch alle Markierungen und Kopfzeilen entfernt. Wenn Sie die Kopfzeilen nicht entfernen möchten, verwenden Sie die Funktion „ QTableWidget::clearContents()“. Die Tabellenabmessungen bleiben unverändert.

[slot] void QTableWidget::clearContents()

Entfernt alle Elemente aus der Ansicht, die nicht in den Kopfzeilen enthalten sind. Dadurch werden auch alle Markierungen aufgehoben. Die Tabellenabmessungen bleiben unverändert.

void QTableWidget::closePersistentEditor(QTableWidgetItem *item)

Schließt den persistenten Editor für item.

Siehe auch ` openPersistentEditor()` und ` isPersistentEditorOpen()`.

int QTableWidget::column(const QTableWidgetItem *item) const

Gibt die Spalte für die „ item “ zurück.

int QTableWidget::columnCount() const

Gibt die Anzahl der Spalten zurück.

Siehe auch ` setColumnCount()`.

[signal] void QTableWidget::currentCellChanged(int currentRow, int currentColumn, int previousRow, int previousColumn)

Dieses Signal wird immer dann ausgelöst, wenn sich die aktuelle Zelle ändert. Die durch previousRow und previousColumn angegebene Zelle ist die Zelle, die zuvor den Fokus hatte; die durch currentRow und currentColumn angegebene Zelle ist die neue aktuelle Zelle.

int QTableWidget::currentColumn() const

Gibt die Spalte des aktuellen Elements zurück.

Siehe auch currentRow() und setCurrentCell().

QTableWidgetItem *QTableWidget::currentItem() const

Gibt das aktuelle Element zurück.

Siehe auch „ setCurrentItem()“.

[signal] void QTableWidget::currentItemChanged(QTableWidgetItem *current, QTableWidgetItem *previous)

Dieses Signal wird immer dann ausgelöst, wenn sich das aktuelle Element ändert. Das Element „ previous “ ist das Element, das zuvor den Fokus hatte, „ current “ ist das neue aktuelle Element.

int QTableWidget::currentRow() const

Gibt die Zeile des aktuellen Elements zurück.

Siehe auch currentColumn() und setCurrentCell().

[override virtual protected] void QTableWidget::dropEvent(QDropEvent *event)

Implementiert: ` QTableView::dropEvent(QDropEvent *event)`.

[virtual protected] bool QTableWidget::dropMimeData(int row, int column, const QMimeData *data, Qt::DropAction action)

Verarbeitet das durch einen Drag-and-Drop-Vorgang bereitgestellte „ data “, der mit dem angegebenen „ action “ im angegebenen „ row “ und „ column “ endete. Gibt „ true “ zurück, wenn die Daten und die Aktion vom Modell verarbeitet werden können; andernfalls wird „ false “ zurückgegeben.

Siehe auch supportedDropActions() und supportedDragActions.

void QTableWidget::editItem(QTableWidgetItem *item)

Beginnt mit der Bearbeitung der „ item “, sofern diese bearbeitbar ist.

[override virtual protected] bool QTableWidget::event(QEvent *e)

Umsetzt: ` QAbstractItemView::event(QEvent *event)`.

QList<QTableWidgetItem *> QTableWidget::findItems(const QString &text, Qt::MatchFlags flags) const

Sucht nach Elementen, die dem „ text “ entsprechen, unter Verwendung des angegebenen „ flags “.

QTableWidgetItem *QTableWidget::horizontalHeaderItem(int column) const

Gibt das horizontale Kopfzeilenelement für die Spalte „ column “ zurück, sofern eines festgelegt wurde; andernfalls wird „ nullptr “ zurückgegeben.

Siehe auch setHorizontalHeaderItem().

QModelIndex QTableWidget::indexFromItem(const QTableWidgetItem *item) const

Gibt den mit dem angegebenen ` item` verknüpften ` QModelIndex ` zurück.

[slot] void QTableWidget::insertColumn(int column)

Fügt eine leere Spalte in die Tabelle unter column ein.

[slot] void QTableWidget::insertRow(int row)

Fügt eine leere Zeile in die Tabelle unter row ein.

bool QTableWidget::isPersistentEditorOpen(QTableWidgetItem *item) const

Gibt zurück, ob für das Element item ein persistenter Editor geöffnet ist.

Siehe auch ` openPersistentEditor()` und ` closePersistentEditor()`.

QTableWidgetItem *QTableWidget::item(int row, int column) const

Gibt das Element für die angegebenen Werte „ row “ und „ column “ zurück, sofern diese festgelegt wurden; andernfalls wird „ nullptr “ zurückgegeben.

Siehe auch setItem().

[signal] void QTableWidget::itemActivated(QTableWidgetItem *item)

Dieses Signal wird ausgegeben, wenn die angegebene Funktion „ item “ aktiviert wurde.

QTableWidgetItem *QTableWidget::itemAt(const QPoint &point) const

Gibt einen Zeiger auf das Element unter der angegebenen Adresse „ point “ zurück oder gibt „ nullptr “ zurück, wenn „ point “ nicht von einem Element im Tabellen-Widget abgedeckt wird.

Siehe auch ` item()`.

QTableWidgetItem *QTableWidget::itemAt(int ax, int ay) const

Gibt das Element an der Position zurück, die im Koordinatensystem des Tabellen-Widgets den Koordinaten QPoint(ax, ay) entspricht, oder gibt nullptr zurück, wenn der angegebene Punkt nicht von einem Element im Tabellen-Widget abgedeckt wird.

Siehe auch item().

[signal] void QTableWidget::itemChanged(QTableWidgetItem *item)

Dieses Signal wird immer dann ausgesendet, wenn sich die Daten von „ item “ geändert haben.

[signal] void QTableWidget::itemClicked(QTableWidgetItem *item)

Dieses Signal wird ausgelöst, sobald auf ein Element in der Tabelle geklickt wird. Das angegebene ` item ` ist das Element, auf das geklickt wurde.

[signal] void QTableWidget::itemDoubleClicked(QTableWidgetItem *item)

Dieses Signal wird ausgelöst, sobald ein Element in der Tabelle doppelt angeklickt wird. Das angegebene ` item ` ist das Element, das doppelt angeklickt wurde.

[signal] void QTableWidget::itemEntered(QTableWidgetItem *item)

Dieses Signal wird ausgelöst, wenn der Mauszeiger in ein Element eintritt. Die „ item “ ist das Element, in das der Mauszeiger eingetreten ist.

Dieses Signal wird nur ausgelöst, wenn „mouseTracking“ aktiviert ist oder wenn beim Bewegen in ein Element eine Maustaste gedrückt wird.

QTableWidgetItem *QTableWidget::itemFromIndex(const QModelIndex &index) const

Gibt einen Zeiger auf den „ QTableWidgetItem “ zurück, der mit dem angegebenen „ index “ verknüpft ist.

[signal] void QTableWidget::itemPressed(QTableWidgetItem *item)

Dieses Signal wird ausgelöst, sobald ein Element in der Tabelle angeklickt wird. Das angegebene ` item ` ist das Element, das angeklickt wurde.

const QTableWidgetItem *QTableWidget::itemPrototype() const

Gibt den von der Tabelle verwendeten Elementprototyp zurück.

Siehe auch ` setItemPrototype()`.

[signal] void QTableWidget::itemSelectionChanged()

Dieses Signal wird immer dann ausgelöst, wenn sich die Auswahl ändert.

Siehe auch selectedItems() und QTableWidgetItem::isSelected().

QList<QTableWidgetItem *> QTableWidget::items(const QMimeData *data) const

Gibt eine Liste von Zeigern auf die im Objekt „ data “ enthaltenen Elemente zurück. Wenn das Objekt nicht durch einen „ QTreeWidget “ im selben Prozess erstellt wurde, ist die Liste leer.

[virtual protected] QMimeData *QTableWidget::mimeData(const QList<QTableWidgetItem *> &items) const

Gibt ein Objekt zurück, das eine serialisierte Beschreibung der angegebenen ` items` enthält. Das zur Beschreibung der Elemente verwendete Format wird über die Funktion ` mimeTypes()` abgerufen.

Ist die Liste der Elemente leer, wird „ nullptr “ zurückgegeben und nicht eine serialisierte leere Liste.

[virtual protected] QStringList QTableWidget::mimeTypes() const

Gibt eine Liste von MIME-Typen zurück, die zur Beschreibung einer Liste von TableWidget-Elementen verwendet werden können.

Siehe auch ` mimeData()`.

void QTableWidget::openPersistentEditor(QTableWidgetItem *item)

Öffnet einen Editor für die angegebene URL item. Der Editor bleibt nach der Bearbeitung geöffnet.

Siehe auch closePersistentEditor() und isPersistentEditorOpen().

void QTableWidget::removeCellWidget(int row, int column)

Entfernt das Widget-Set aus der Zelle, die durch „ row “ und „ column “ angegeben ist.

[slot] void QTableWidget::removeColumn(int column)

Entfernt die Spalte „ column “ und alle darin enthaltenen Einträge aus der Tabelle.

[slot] void QTableWidget::removeRow(int row)

Entfernt die Zeile „ row “ sowie alle darin enthaltenen Elemente aus der Tabelle.

int QTableWidget::row(const QTableWidgetItem *item) const

Gibt die Zeile für die „ item “ zurück.

int QTableWidget::rowCount() const

Gibt die Anzahl der Zeilen zurück.

Siehe auch ` setRowCount()`.

[slot] void QTableWidget::scrollToItem(const QTableWidgetItem *item, QAbstractItemView::ScrollHint hint = EnsureVisible)

Blättert die Ansicht bei Bedarf, um sicherzustellen, dass die „ item “ sichtbar ist. Der Parameter „ hint “ legt genauer fest, wo sich die „ item “ nach dem Vorgang befinden soll.

QList<QTableWidgetItem *> QTableWidget::selectedItems() const

Gibt eine Liste aller ausgewählten Elemente zurück.

Diese Funktion gibt eine Liste von Zeigern auf den Inhalt der ausgewählten Zellen zurück. Verwenden Sie die Funktion ` selectedIndexes()` (), um die gesamte Auswahl einschließlich leerer Zellen abzurufen.

Siehe auch ` selectedIndexes()`.

QList<QTableWidgetSelectionRange> QTableWidget::selectedRanges() const

Gibt eine Liste aller ausgewählten Bereiche zurück.

Siehe auch QTableWidgetSelectionRange.

void QTableWidget::setCellWidget(int row, int column, QWidget *widget)

Legt das angegebene „ widget “ fest, das in der Zelle unter den angegebenen Koordinaten „ row “ und „ column “ angezeigt werden soll, und überträgt dabei das Eigentumsrecht an dem Widget an die Tabelle.

Wird das Zellen-Widget A durch das Zellen-Widget B ersetzt, wird das Zellen-Widget A gelöscht. Im folgenden Codeausschnitt wird beispielsweise das Objekt „ QLineEdit “ gelöscht.

setCellWidget(row, column, new QLineEdit);
...
setCellWidget(row, column, new QTextEdit);

Siehe auch cellWidget().

void QTableWidget::setColumnCount(int columns)

Legt die Anzahl der Spalten im Modell dieser Tabelle auf „ columns “ fest. Ist dieser Wert kleiner als „ columnCount()“, werden die Daten in den nicht benötigten Spalten verworfen.

Siehe auch „ columnCount()“ und „ setRowCount()“.

void QTableWidget::setCurrentCell(int row, int column)

Legt die aktuelle Zelle als die Zelle an der Position (row, column) fest.

Je nach dem aktuellen selection mode kann die Zelle auch ausgewählt werden.

Siehe auch setCurrentItem(), currentRow() und currentColumn().

void QTableWidget::setCurrentCell(int row, int column, QItemSelectionModel::SelectionFlags command)

Setzt die aktuelle Zelle auf die Zelle an der Position (row, column) unter Verwendung des angegebenen command.

Siehe auch setCurrentItem(), currentRow() und currentColumn().

void QTableWidget::setCurrentItem(QTableWidgetItem *item)

Setzt das aktuelle Element auf „ item “.

Sofern der Auswahlmodus nicht „ NoSelection “ ist, wird das Element zusätzlich ausgewählt.

Siehe auch „ currentItem()“ und „ setCurrentCell()“.

void QTableWidget::setCurrentItem(QTableWidgetItem *item, QItemSelectionModel::SelectionFlags command)

Setzt das aktuelle Element auf „ item “ unter Verwendung des angegebenen „ command “.

Siehe auch „ currentItem()“ und „ setCurrentCell()“.

void QTableWidget::setHorizontalHeaderItem(int column, QTableWidgetItem *item)

Legt den horizontalen Kopfzeileneintrag für die Spalte „ column “ auf „ item “ fest. Falls erforderlich, wird die Anzahl der Spalten erhöht, um den Eintrag unterzubringen. Der vorherige Kopfzeileneintrag (sofern vorhanden) wird gelöscht.

Siehe auch „ horizontalHeaderItem()“.

void QTableWidget::setHorizontalHeaderLabels(const QStringList &labels)

Legt die horizontalen Kopfzeilenbeschriftungen mithilfe von „ labels “ fest.

void QTableWidget::setItem(int row, int column, QTableWidgetItem *item)

Setzt das Element für die angegebenen Werte „ row “ und „ column “ auf „ item “.

Die Tabelle übernimmt die Eigentumsrechte an dem Element.

Beachten Sie: Wenn die Sortierung aktiviert ist (siehe sortingEnabled) und column die aktuelle Sortierspalte ist, wird row an die sortierte Position verschoben, die durch item bestimmt wird.

Wenn Sie mehrere Elemente einer bestimmten Zeile setzen möchten (z. B. durch Aufruf von `setItem()` in einer Schleife), sollten Sie die Sortierung zuvor deaktivieren und anschließend wieder aktivieren; dadurch können Sie für alle Elemente derselben Zeile dasselbe ` row `-Argument verwenden (d. h., `setItem()` verschiebt die Zeile nicht).

Siehe auch ` item()` und ` takeItem()`.

void QTableWidget::setItemPrototype(const QTableWidgetItem *item)

Legt den Elementprototyp für die Tabelle auf den angegebenen item fest.

Das Tabellen-Widget verwendet die Klonfunktion des Elementprototyps, wenn es ein neues Tabellenelement erstellen muss. Dies ist beispielsweise der Fall, wenn der Benutzer eine leere Zelle bearbeitet. Dies ist nützlich, wenn Sie eine Unterklasse von ` QTableWidgetItem ` haben und sicherstellen möchten, dass ` QTableWidget ` Instanzen Ihrer Unterklasse erstellt.

Die Tabelle übernimmt die Eigentümerschaft am Prototyp.

Siehe auch ` itemPrototype()`.

void QTableWidget::setRangeSelected(const QTableWidgetSelectionRange &range, bool select)

Aktiviert oder deaktiviert die Option „ range “ ( ) je nach der Einstellung unter „ select “ ( ).

void QTableWidget::setRowCount(int rows)

Legt die Anzahl der Zeilen im Modell dieser Tabelle auf ` rows` fest. Ist dieser Wert kleiner als ` rowCount()`, werden die Daten in den nicht gewünschten Zeilen verworfen.

Siehe auch „ rowCount()“ und „ setColumnCount()“.

void QTableWidget::setVerticalHeaderItem(int row, QTableWidgetItem *item)

Setzt das vertikale Kopfzeilenelement für die Zeile „ row “ auf „ item “.

Siehe auch ` verticalHeaderItem()`.

void QTableWidget::setVerticalHeaderLabels(const QStringList &labels)

Legt die vertikalen Kopfzeilenbeschriftungen mithilfe von „ labels “ fest.

void QTableWidget::sortItems(int column, Qt::SortOrder order = Qt::AscendingOrder)

Sortiert alle Zeilen im Tabellen-Widget anhand von column und order.

[virtual protected] Qt::DropActions QTableWidget::supportedDropActions() const

Gibt die von dieser Ansicht unterstützten Drag-and-Drop-Aktionen zurück.

Siehe auch „ Qt::DropActions“ , „ supportedDragActions “ und „ dropMimeData()“.

QTableWidgetItem *QTableWidget::takeHorizontalHeaderItem(int column)

Entfernt den horizontalen Kopfzeilenpunkt unter „ column “ aus der Kopfzeile, ohne ihn zu löschen.

QTableWidgetItem *QTableWidget::takeItem(int row, int column)

Entfernt den Eintrag unter row und column aus der Tabelle, ohne ihn zu löschen.

QTableWidgetItem *QTableWidget::takeVerticalHeaderItem(int row)

Entfernt das vertikale Kopfzeilenelement unter row aus der Kopfzeile, ohne es zu löschen.

QTableWidgetItem *QTableWidget::verticalHeaderItem(int row) const

Gibt das vertikale Kopfzeilenelement für die Zeile row zurück.

Siehe auch ` setVerticalHeaderItem()`.

int QTableWidget::visualColumn(int logicalColumn) const

Gibt die visuelle Spalte des angegebenen ` logicalColumn` zurück.

QRect QTableWidget::visualItemRect(const QTableWidgetItem *item) const

Gibt das Rechteck im Ansichtsbereich zurück, das das Element unter item einnimmt.

int QTableWidget::visualRow(int logicalRow) const

Gibt die visuelle Zeile des angegebenen „ logicalRow “ zurück.