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 Tabellensicht mit den angegebenen rows und columns, und mit der angegebenen parent.

[virtual noexcept] QTableWidget::~QTableWidget()

Zerstört diese QTableWidget.

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

Dieses Signal wird ausgesendet, wenn die durch row und column angegebene Zelle aktiviert wurde.

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

Dieses Signal wird ausgegeben, wenn sich die Daten des Elements in der durch row und column angegebenen Zelle geändert haben.

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

Dieses Signal wird ausgegeben, wenn eine Zelle in der Tabelle angeklickt wird. Als row und column wird die Zelle angegeben, auf die geklickt wurde.

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

Dieses Signal wird ausgegeben, wenn eine Zelle in der Tabelle doppelt angeklickt wird. Als row und column wird die Zelle angegeben, auf die doppelt geklickt wurde.

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

Dieses Signal wird ausgegeben, wenn der Mauszeiger eine Zelle betritt. Die Zelle wird durch row und column festgelegt.

Dieses Signal wird nur ausgegeben, wenn mouseTracking eingeschaltet ist oder wenn eine Maustaste gedrückt wird, während man sich in ein Element bewegt.

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

Dieses Signal wird ausgegeben, wenn eine Zelle in der Tabelle gedrückt wird. Unter row und column wird die Zelle angegeben, die gedrückt wurde.

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

Gibt das in der Zelle angezeigte Widget in der angegebenen row und column zurück.

Siehe auch setCellWidget().

[slot] void QTableWidget::clear()

Entfernt alle Elemente in der Ansicht. Dabei werden auch alle Markierungen und Überschriften entfernt. Wenn Sie die Kopfzeilen nicht entfernen möchten, verwenden Sie QTableWidget::clearContents(). Die Abmessungen der Tabelle bleiben unverändert.

[slot] void QTableWidget::clearContents()

Entfernt alle Elemente, die nicht in den Kopfzeilen enthalten sind, aus der Ansicht. Dadurch werden auch alle Markierungen entfernt. Die Abmessungen der Tabelle 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 ausgegeben, 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 ausgegeben, 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 Eintrags zurück.

Siehe auch currentColumn() und setCurrentCell().

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

Reimplements: QTableView::dropEvent(QDropEvent *event).

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

Verarbeitet die data, die von einer Drag&Drop-Operation geliefert wurde, die mit dem angegebenen action in den 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().

void QTableWidget::editItem(QTableWidgetItem *item)

Beginnt mit der Bearbeitung von item, sofern es bearbeitbar ist.

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

Reimplements: QAbstractItemView::event(QEvent *Event).

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

Findet Elemente, die mit dem text übereinstimmen, unter Verwendung der angegebenen flags.

QTableWidgetItem *QTableWidget::horizontalHeaderItem(int column) const

Gibt die horizontale Kopfzeile für die Spalte column zurück, sofern eine solche festgelegt wurde; andernfalls wird nullptr zurückgegeben.

Siehe auch setHorizontalHeaderItem().

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

Gibt die QModelIndex zurück, die mit dem angegebenen item verbunden ist.

[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 ein persistenter Editor für das Element item geöffnet ist.

Siehe auch openPersistentEditor() und closePersistentEditor().

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

Gibt das Element für die angegebenen row und column zurück, wenn eines gesetzt wurde; andernfalls wird nullptr zurückgegeben.

Siehe auch setItem().

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

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

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

Gibt einen Zeiger auf das Element am angegebenen point zurück oder gibt nullptr zurück, wenn point nicht durch ein Element im Tabellen-Widget abgedeckt ist.

Siehe auch item().

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

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

Siehe auch item().

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

Dieses Signal wird ausgegeben, wenn sich die Daten von item geändert haben.

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

Dieses Signal wird ausgegeben, wenn ein Element in der Tabelle angeklickt wird. Die angegebene item ist das Element, das angeklickt wurde.

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

Dieses Signal wird ausgegeben, wenn ein Element in der Tabelle doppelt angeklickt wird. Die angegebene item ist das Element, auf das doppelt geklickt wurde.

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

Dieses Signal wird ausgegeben, wenn der Mauszeiger ein Element betritt. Die Adresse item ist der eingegebene Eintrag.

Dieses Signal wird nur ausgegeben, wenn das mouseTracking eingeschaltet ist oder wenn eine Maustaste gedrückt wird, während der Mauszeiger in ein Element bewegt wird.

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

Gibt einen Zeiger auf den QTableWidgetItem zurück, der mit dem angegebenen index verbunden ist.

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

Dieses Signal wird ausgegeben, wenn ein Element in der Tabelle gedrückt wird. Das angegebene item ist das Element, das gedrückt wurde.

const QTableWidgetItem *QTableWidget::itemPrototype() const

Gibt den von der Tabelle verwendeten Prototyp des Elements zurück.

Siehe auch setItemPrototype().

[signal] void QTableWidget::itemSelectionChanged()

Dieses Signal wird immer dann ausgegeben, 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. Wurde das Objekt nicht von einem QTreeWidget im selben Prozess erstellt, ist die Liste leer.

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

Gibt ein Objekt zurück, das eine serialisierte Beschreibung des angegebenen items enthält. Das zur Beschreibung der Elemente verwendete Format wird von der Funktion mimeTypes() bezogen.

Wenn die Liste der Elemente leer ist, 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 item. Der Editor bleibt nach der Bearbeitung geöffnet.

Siehe auch closePersistentEditor() und isPersistentEditorOpen().

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

Entfernt das Widget, das auf die durch row und column angegebene Zelle gesetzt wurde.

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

Entfernt die Spalte column und alle darin enthaltenen Elemente aus der Tabelle.

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

Entfernt die Zeile row und alle ihre 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)

Scrollt die Ansicht, falls erforderlich, um sicherzustellen, dass item sichtbar ist. Der Parameter hint gibt genauer an, 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 so fest, dass es in der Zelle in den angegebenen row und column angezeigt wird, und übergibt den Besitz des Widgets an die Tabelle.

Wenn das Zellen-Widget A durch das Zellen-Widget B ersetzt wird, wird das Zellen-Widget A gelöscht. Zum Beispiel wird im nachstehenden Codeschnipsel das Objekt QLineEdit gelöscht.

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

Siehe auch cellWidget().

void QTableWidget::setColumnCount(int columns)

Setzt die Anzahl der Spalten im Modell dieser Tabelle auf columns. Ist diese 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)

Setzt die aktuelle Zelle auf die Zelle an der Position (row, column).

Je nach der 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.

Wenn der Auswahlmodus nicht NoSelection ist, wird der Eintrag ebenfalls 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)

Setzt die horizontale Kopfzeile für die Spalte column auf item. Falls erforderlich, wird die Anzahl der Spalten erhöht, um die Position einzupassen. Die vorherige Kopfzeile (falls vorhanden) wird gelöscht.

Siehe auch horizontalHeaderItem().

void QTableWidget::setHorizontalHeaderLabels(const QStringList &labels)

Legt die horizontalen Kopfzeilenbeschriftungen mit labels fest.

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

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

Die Tabelle übernimmt das Eigentum an dem Element.

Beachten Sie, dass, wenn die Sortierung aktiviert ist (siehe sortingEnabled) und column die aktuelle Sortierspalte ist, row an die durch item bestimmte Sortierposition verschoben wird.

Wenn Sie mehrere Elemente einer bestimmten Zeile setzen wollen (z. B. durch den Aufruf von setItem() in einer Schleife), sollten Sie die Sortierung vorher ausschalten und danach wieder einschalten; so können Sie dasselbe row Argument für alle Elemente in derselben Zeile verwenden (d. h. setItem() wird die Zeile nicht verschieben).

Siehe auch item() und takeItem().

void QTableWidget::setItemPrototype(const QTableWidgetItem *item)

Setzt den Elementprototyp für die Tabelle auf den angegebenen item.

Das Tabellen-Widget verwendet die Funktion zum Klonen des Elementprototyps, wenn es ein neues Tabellenelement erstellen muss. Zum Beispiel, wenn der Benutzer in einer leeren Zelle editiert. Dies ist nützlich, wenn Sie eine QTableWidgetItem Unterklasse haben und sicherstellen wollen, dass QTableWidget Instanzen Ihrer Unterklasse erstellt.

Die Tabelle übernimmt den Besitz des Prototyps.

Siehe auch itemPrototype().

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

Aktiviert oder deaktiviert die range je nach select.

void QTableWidget::setRowCount(int rows)

Setzt die Anzahl der Zeilen im Modell dieser Tabelle auf rows. Ist diese kleiner als rowCount(), werden die Daten in den nicht benötigten Zeilen verworfen.

Siehe auch rowCount() und setColumnCount().

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

Setzt die vertikale Kopfzeile für die Zeile row auf item.

Siehe auch verticalHeaderItem().

void QTableWidget::setVerticalHeaderLabels(const QStringList &labels)

Legt die vertikalen Kopfzeilenbeschriftungen mit labels fest.

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

Sortiert alle Zeilen im Tabellen-Widget basierend auf column und order.

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

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

Siehe auch Qt::DropActions.

QTableWidgetItem *QTableWidget::takeHorizontalHeaderItem(int column)

Entfernt die horizontale Kopfzeile unter column aus der Kopfzeile, ohne sie 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 die vertikale Kopfzeile unter row aus der Kopfzeile, ohne sie zu löschen.

QTableWidgetItem *QTableWidget::verticalHeaderItem(int row) const

Gibt die vertikale Kopfzeile für die Zeile row zurück.

Siehe auch setVerticalHeaderItem().

int QTableWidget::visualColumn(int logicalColumn) const

Gibt die visuelle Spalte der angegebenen logicalColumn zurück.

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

Gibt das Rechteck im Ansichtsfenster zurück, das von dem Element auf item eingenommen wird.

int QTableWidget::visualRow(int logicalRow) const

Gibt die visuelle Zeile der angegebenen logicalRow zurück.