QTableView Class

Dokumentation der Mitgliedsfunktionen

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

Konstruiert eine Tabellensicht mit einer parent zur Darstellung der Daten.

Siehe auch QAbstractItemModel.

[virtual noexcept] QTableView::~QTableView()

Zerstört die Tabellenansicht.

void QTableView::clearSpans()

Entfernt alle Zeilen- und Spaltenabstände in der Tabellendarstellung.

Siehe auch setSpan().

int QTableView::columnAt(int x) const

Gibt die Spalte zurück, in der sich die angegebene x-Koordinate, x, in Inhaltskoordinaten befindet.

Siehe auch rowAt().

[protected slot] void QTableView::columnCountChanged(int oldCount, int newCount)

Dieser Slot wird immer dann aufgerufen, wenn Spalten hinzugefügt oder gelöscht werden. Die vorherige Anzahl der Spalten wird durch oldCount angegeben, die neue Anzahl der Spalten durch newCount.

[protected slot] void QTableView::columnMoved(int column, int oldIndex, int newIndex)

Dieser Slot wird aufgerufen, um den Index der angegebenen column in der Tabellenansicht zu ändern. Der alte Index wird durch oldIndex angegeben, der neue Index durch newIndex.

Siehe auch rowMoved().

[protected slot] void QTableView::columnResized(int column, int oldWidth, int newWidth)

Dieser Slot wird aufgerufen, um die Breite der angegebenen column zu ändern. Die alte Breite wird durch oldWidth angegeben, die neue Breite durch newWidth.

Siehe auch rowResized().

int QTableView::columnSpan(int row, int column) const

Gibt die Spaltenspanne des Tabellenelements bei (row, column) zurück. Die Vorgabe ist 1.

Siehe auch setSpan() und rowSpan().

int QTableView::columnViewportPosition(int column) const

Gibt die x-Koordinate in Inhaltskoordinaten der angegebenen column zurück.

int QTableView::columnWidth(int column) const

Gibt die Breite der angegebenen column zurück.

Siehe auch setColumnWidth(), resizeColumnToContents(), und rowHeight().

[override virtual protected] void QTableView::currentChanged(const QModelIndex &current, const QModelIndex &previous)

Reimplements: QAbstractItemView::currentChanged(const QModelIndex &current, const QModelIndex &previous).

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

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

[slot] void QTableView::hideColumn(int column)

Blendet die angegebene column aus.

Siehe auch showColumn() und hideRow().

[slot] void QTableView::hideRow(int row)

Blendet die angegebene row aus.

Siehe auch showRow() und hideColumn().

QHeaderView *QTableView::horizontalHeader() const

Liefert die horizontale Kopfzeile des Tabellenviews.

Siehe auch setHorizontalHeader(), verticalHeader(), und QAbstractItemModel::headerData().

[override virtual protected] int QTableView::horizontalOffset() const

Reimplements: QAbstractItemView::horizontalOffset() const.

Gibt den horizontalen Versatz der Elemente in der Tabellendarstellung zurück.

Beachten Sie, dass die Tabellendarstellung die Positionen der horizontalen Kopfabschnitte verwendet, um die Positionen der Spalten in der Darstellung zu bestimmen.

Siehe auch verticalOffset().

[override virtual] QModelIndex QTableView::indexAt(const QPoint &pos) const

Reimplements: QAbstractItemView::indexAt(const QPoint &point) const.

Gibt die Indexposition des Modellelements zurück, das dem Tabellenelement an der Position pos in Inhaltskoordinaten entspricht.

[override virtual protected] void QTableView::initViewItemOption(QStyleOptionViewItem *option) const

Reimplements: QAbstractItemView::initViewItemOption(QStyleOptionViewItem *option) const.

bool QTableView::isColumnHidden(int column) const

Gibt true zurück, wenn die angegebene column ausgeblendet ist; andernfalls wird false zurückgegeben.

Siehe auch isRowHidden().

[override virtual protected] bool QTableView::isIndexHidden(const QModelIndex &index) const

Reimplements: QAbstractItemView::isIndexHidden(const QModelIndex &index) const.

bool QTableView::isRowHidden(int row) const

Gibt true zurück, wenn die angegebene row ausgeblendet ist; andernfalls wird false zurückgegeben.

Siehe auch isColumnHidden().

[override virtual protected] QModelIndex QTableView::moveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers)

Reimplements: QAbstractItemView::moveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers).

Bewegt den Cursor in Übereinstimmung mit dem angegebenen cursorAction unter Verwendung der von modifiers bereitgestellten Informationen.

Siehe auch QAbstractItemView::CursorAction.

[override virtual protected] void QTableView::paintEvent(QPaintEvent *event)

Reimplements: QAbstractScrollArea::paintEvent(QPaintEvent *event).

Zeichnet die Tabelle bei Empfang des angegebenen Paint-Events event.

[slot] void QTableView::resizeColumnToContents(int column)

Ändert die Größe der angegebenen column basierend auf den Größenhinweisen des Delegaten, der zum Rendern jedes Elements in der Spalte verwendet wird.

Siehe auch resizeColumnsToContents(), sizeHintForColumn(), und QHeaderView::resizeContentsPrecision().

[slot] void QTableView::resizeColumnsToContents()

Ändert die Größe aller Spalten basierend auf den Größenhinweisen des Delegaten, der zum Rendern jedes Elements in den Spalten verwendet wird.

Siehe auch resizeColumnToContents(), sizeHintForColumn(), und QHeaderView::resizeContentsPrecision().

[slot] void QTableView::resizeRowToContents(int row)

Ändert die Größe der angegebenen row basierend auf den Größenhinweisen des Delegaten, der zum Rendern jedes Elements in der Zeile verwendet wird.

Siehe auch resizeRowsToContents(), sizeHintForRow(), und QHeaderView::resizeContentsPrecision().

[slot] void QTableView::resizeRowsToContents()

Ändert die Größe aller Zeilen basierend auf den Größenhinweisen des Delegaten, der zum Rendern jedes Elements in den Zeilen verwendet wird.

Siehe auch resizeRowToContents(), sizeHintForRow(), und QHeaderView::resizeContentsPrecision().

int QTableView::rowAt(int y) const

Gibt die Zeile zurück, in der sich die angegebene y-Koordinate y in den Inhaltskoordinaten befindet.

Siehe auch columnAt().

[protected slot] void QTableView::rowCountChanged(int oldCount, int newCount)

Dieser Slot wird immer dann aufgerufen, wenn Zeilen hinzugefügt oder gelöscht werden. Die vorherige Anzahl der Zeilen wird durch oldCount angegeben, die neue Anzahl der Zeilen durch newCount.

int QTableView::rowHeight(int row) const

Gibt die Höhe des angegebenen row zurück.

Siehe auch setRowHeight(), resizeRowToContents(), und columnWidth().

[protected slot] void QTableView::rowMoved(int row, int oldIndex, int newIndex)

Dieser Slot wird aufgerufen, um den Index der angegebenen row in der Tabellenansicht zu ändern. Der alte Index wird durch oldIndex angegeben, der neue Index durch newIndex.

Siehe auch columnMoved().

[protected slot] void QTableView::rowResized(int row, int oldHeight, int newHeight)

Dieser Slot wird aufgerufen, um die Höhe der angegebenen row zu ändern. Die alte Höhe wird durch oldHeight angegeben, die neue Höhe durch newHeight.

Siehe auch columnResized().

int QTableView::rowSpan(int row, int column) const

Gibt die Zeilenspanne des Tabellenelements bei (row, column) zurück. Die Vorgabe ist 1.

Siehe auch setSpan() und columnSpan().

int QTableView::rowViewportPosition(int row) const

Gibt die y-Koordinate in Inhaltskoordinaten der angegebenen row zurück.

[override virtual protected] void QTableView::scrollContentsBy(int dx, int dy)

Reimplements: QAbstractScrollArea::scrollContentsBy(int dx, int dy).

Scrollt den Inhalt der Tabellenansicht um (dx, dy).

[override virtual] void QTableView::scrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint = EnsureVisible)

Reimplements: QAbstractItemView::scrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint).

Stellt sicher, dass die angegebene index in der Tabellenansicht sichtbar ist und scrollt, falls erforderlich.

[slot] void QTableView::selectColumn(int column)

Wählt die angegebene column in der Tabellendarstellung aus, wenn der aktuelle SelectionMode und SelectionBehavior die Auswahl von Spalten zulassen.

Siehe auch selectRow().

[slot] void QTableView::selectRow(int row)

Wählt die angegebene row in der Tabellensicht aus, wenn der aktuelle SelectionMode und SelectionBehavior die Auswahl von Zeilen erlaubt.

Siehe auch selectColumn().

[override virtual protected] QModelIndexList QTableView::selectedIndexes() const

Reimplements: QAbstractItemView::selectedIndexes() const.

[override virtual protected] void QTableView::selectionChanged(const QItemSelection &selected, const QItemSelection &deselected)

Reimplements: QAbstractItemView::selectionChanged(const QItemSelection &selected, const QItemSelection &deselected).

void QTableView::setColumnHidden(int column, bool hide)

Wenn hide true ist, wird die angegebene column ausgeblendet; andernfalls wird sie angezeigt.

Siehe auch isColumnHidden() und setRowHidden().

void QTableView::setColumnWidth(int column, int width)

Setzt die Breite des angegebenen column auf width.

Siehe auch columnWidth().

void QTableView::setHorizontalHeader(QHeaderView *header)

Setzt das für die horizontale Kopfzeile zu verwendende Widget auf header.

Siehe auch horizontalHeader() und setVerticalHeader().

[override virtual] void QTableView::setModel(QAbstractItemModel *model)

Reimplements: QAbstractItemView::setModel(QAbstractItemModel *model).

[override virtual] void QTableView::setRootIndex(const QModelIndex &index)

Reimplements: QAbstractItemView::setRootIndex(const QModelIndex &index).

void QTableView::setRowHeight(int row, int height)

Setzt die Höhe des angegebenen row auf height.

Siehe auch rowHeight().

void QTableView::setRowHidden(int row, bool hide)

Wenn hide wahr ist, wird row ausgeblendet, andernfalls wird es angezeigt.

Siehe auch isRowHidden() und setColumnHidden().

[override virtual protected] void QTableView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags flags)

Reimplements: QAbstractItemView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags flags).

Wählt die Elemente innerhalb des angegebenen rect und gemäß der angegebenen Auswahl flags aus.

[override virtual] void QTableView::setSelectionModel(QItemSelectionModel *selectionModel)

Reimplements: QAbstractItemView::setSelectionModel(QItemSelectionModel *selectionModel).

void QTableView::setSortingEnabled(bool enable)

Wenn enable wahr ist, wird die Sortierung für die Tabelle aktiviert und sofort ein Aufruf von sortByColumn() mit dem aktuellen Sortierbereich und der Reihenfolge ausgelöst.

Siehe auch isSortingEnabled().

void QTableView::setSpan(int row, int column, int rowSpanCount, int columnSpanCount)

Setzt die Spanne des Tabellenelements bei (row, column) auf die durch (rowSpanCount, columnSpanCount) angegebene Anzahl von Zeilen und Spalten.

Siehe auch rowSpan() und columnSpan().

void QTableView::setVerticalHeader(QHeaderView *header)

Setzt das für die vertikale Kopfzeile zu verwendende Widget auf header.

Siehe auch verticalHeader() und setHorizontalHeader().

[slot] void QTableView::showColumn(int column)

Zeigen Sie die angegebene column.

Siehe auch hideColumn() und showRow().

[slot] void QTableView::showRow(int row)

Zeigen Sie die angegebene row.

Siehe auch hideRow() und showColumn().

[override virtual protected] int QTableView::sizeHintForColumn(int column) const

Reimplements: QAbstractItemView::sizeHintForColumn(int column) const.

Gibt den Größenhinweis für die Breite der angegebenen column zurück oder -1, wenn es kein Modell gibt.

Wenn Sie die Breite einer gegebenen Spalte auf einen festen Wert setzen müssen, rufen Sie QHeaderView::resizeSection() für die horizontale Kopfzeile der Tabelle auf.

Wenn Sie diese Funktion in einer Unterklasse neu implementieren, beachten Sie, dass der von Ihnen zurückgegebene Wert verwendet wird, wenn resizeColumnToContents() oder QHeaderView::resizeSections() aufgerufen wird. Wenn entweder die horizontale Kopfzeile oder der Elementdelegat eine größere Spaltenbreite erfordert, wird stattdessen die größere Breite verwendet.

Siehe auch QWidget::sizeHint, horizontalHeader(), und QHeaderView::resizeContentsPrecision().

[override virtual protected] int QTableView::sizeHintForRow(int row) const

Reimplements: QAbstractItemView::sizeHintForRow(int row) const.

Gibt den Größenhinweis für die Höhe der angegebenen row zurück oder -1, wenn es kein Modell gibt.

Wenn Sie die Höhe einer bestimmten Zeile auf einen festen Wert setzen müssen, rufen Sie QHeaderView::resizeSection() für die vertikale Kopfzeile der Tabelle auf.

Wenn Sie diese Funktion in einer Unterklasse neu implementieren, beachten Sie, dass der Wert, den Sie zurückgeben, nur verwendet wird, wenn resizeRowToContents() aufgerufen wird. Wenn in diesem Fall eine größere Zeilenhöhe entweder von der vertikalen Kopfzeile oder dem Elementdelegaten benötigt wird, wird stattdessen diese Breite verwendet.

Siehe auch QWidget::sizeHint, verticalHeader(), und QHeaderView::resizeContentsPrecision().

[slot] void QTableView::sortByColumn(int column, Qt::SortOrder order)

Sortiert das Modell nach den Werten in den angegebenen column und order.

column kann -1 sein. In diesem Fall wird kein Sortierindikator angezeigt und das Modell kehrt zu seiner natürlichen, unsortierten Reihenfolge zurück. Beachten Sie, dass nicht alle Modelle dies unterstützen und in diesem Fall sogar abstürzen können.

Siehe auch sortingEnabled.

[override virtual protected] void QTableView::timerEvent(QTimerEvent *event)

Reimplements: QAbstractItemView::timerEvent(QTimerEvent *event).

[override virtual protected] void QTableView::updateGeometries()

Reimplements: QAbstractItemView::updateGeometries().

QHeaderView *QTableView::verticalHeader() const

Gibt die vertikale Kopfzeile der Tabellenansicht zurück.

Siehe auch setVerticalHeader(), horizontalHeader(), und QAbstractItemModel::headerData().

[override virtual protected] int QTableView::verticalOffset() const

Reimplements: QAbstractItemView::verticalOffset() const.

Gibt den vertikalen Versatz der Elemente in der Tabellendarstellung zurück.

Beachten Sie, dass die Tabellenansicht die Positionen der vertikalen Kopfzeilenabschnitte verwendet, um die Positionen der Zeilen in der Ansicht zu bestimmen.

Siehe auch horizontalOffset().

[override virtual protected] QSize QTableView::viewportSizeHint() const

Reimplements: QAbstractItemView::viewportSizeHint() const.

[override virtual] QRect QTableView::visualRect(const QModelIndex &index) const

Reimplements: QAbstractItemView::visualRect(const QModelIndex &index) const.

Gibt das Rechteck auf dem Ansichtsfenster zurück, das von dem angegebenen index belegt wird. Wenn der Index in der Ansicht verborgen ist, wird ein Nullwert zurückgegeben QRect.

[override virtual protected] QRegion QTableView::visualRegionForSelection(const QItemSelection &selection) const

Reimplements: QAbstractItemView::visualRegionForSelection(const QItemSelection &selection) const.

Gibt das Rechteck aus dem Ansichtsfenster der Elemente in der angegebenen selection zurück.

Seit 4.7 enthält die zurückgegebene Region nur Rechtecke, die das Ansichtsfenster schneiden (oder darin enthalten sind).