QAbstractItemView Class

Dokumentation der Mitgliedsfunktionen

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

Konstruiert eine abstrakte Elementansicht mit der angegebenen parent.

[virtual noexcept] QAbstractItemView::~QAbstractItemView()

Zerstört die Aussicht.

[signal] void QAbstractItemView::activated(const QModelIndex &index)

Dieses Signal wird ausgegeben, wenn das durch index angegebene Element durch den Benutzer aktiviert wird. Wie Elemente aktiviert werden, hängt von der Plattform ab, z. B. durch Einfach- oder Doppelklick auf das Element oder durch Drücken der Return- oder Enter-Taste, wenn das Element aktuell ist.

Siehe auch clicked(), doubleClicked(), entered(), und pressed().

[slot] void QAbstractItemView::clearSelection()

Deselektiert alle ausgewählten Elemente. Der aktuelle Index wird nicht geändert.

Siehe auch setSelection() und selectAll().

[signal] void QAbstractItemView::clicked(const QModelIndex &index)

Dieses Signal wird ausgegeben, wenn eine Maustaste mit der linken Maustaste angeklickt wird. Das Element, auf das die Maus geklickt wurde, wird durch index angegeben. Das Signal wird nur ausgegeben, wenn der Index gültig ist.

Siehe auch activated(), doubleClicked(), entered(), und pressed().

[virtual protected slot] void QAbstractItemView::closeEditor(QWidget *editor, QAbstractItemDelegate::EndEditHint hint)

Schließt die angegebene editor und gibt sie frei. Mit hint wird angegeben, wie die Ansicht auf das Ende des Bearbeitungsvorgangs reagieren soll. Zum Beispiel kann der Hinweis darauf hinweisen, dass das nächste Element in der Ansicht zur Bearbeitung geöffnet werden soll.

Siehe auch edit() und commitData().

void QAbstractItemView::closePersistentEditor(const QModelIndex &index)

Schließt den persistenten Editor für das Objekt unter der angegebenen Adresse index.

Siehe auch openPersistentEditor() und isPersistentEditorOpen().

[virtual protected slot] void QAbstractItemView::commitData(QWidget *editor)

Übertragen Sie die Daten in editor in das Modell.

Siehe auch closeEditor().

[virtual protected slot] void QAbstractItemView::currentChanged(const QModelIndex &current, const QModelIndex &previous)

Dieser Slot wird aufgerufen, wenn ein neues Element das aktuelle Element wird. Das vorherige aktuelle Element wird durch den Index previous angegeben, das neue Element durch den Index current.

Wenn Sie über Änderungen an Elementen informiert werden möchten, lesen Sie das Signal dataChanged().

QModelIndex QAbstractItemView::currentIndex() const

Gibt den Modellindex des aktuellen Elements zurück.

Siehe auch setCurrentIndex().

[virtual protected slot] void QAbstractItemView::dataChanged(const QModelIndex &topLeft, const QModelIndex &bottomRight, const QList<int> &roles = QList<int>())

Dieser Slot wird aufgerufen, wenn Elemente mit dem angegebenen roles im Modell geändert werden. Die geänderten Elemente sind diejenigen von topLeft bis einschließlich bottomRight. Wenn nur ein Element geändert wird, ist topLeft == bottomRight.

Die roles, die geändert wurden, können entweder ein leerer Container sein (was bedeutet, dass sich alles geändert hat) oder ein nicht leerer Container mit der Teilmenge der Rollen, die sich geändert haben.

[protected] QPoint QAbstractItemView::dirtyRegionOffset() const

Gibt den Offset der verschmutzten Bereiche in der Ansicht zurück.

Wenn Sie scrollDirtyRegion() verwenden und paintEvent() in einer Unterklasse von QAbstractItemView implementieren, sollten Sie den vom Paint-Ereignis angegebenen Bereich mit dem von dieser Funktion zurückgegebenen Offset übersetzen.

Siehe auch scrollDirtyRegion() und setDirtyRegion().

[signal] void QAbstractItemView::doubleClicked(const QModelIndex &index)

Dieses Signal wird ausgegeben, wenn eine Maustaste doppelt angeklickt wird. Das Element, auf das die Maus doppelt geklickt wurde, wird durch index angegeben. Das Signal wird nur ausgegeben, wenn der Index gültig ist.

Siehe auch clicked() und activated().

[override virtual protected] void QAbstractItemView::dragEnterEvent(QDragEnterEvent *event)

Reimplements: QAbstractScrollArea::dragEnterEvent(QDragEnterEvent *event).

Diese Funktion wird mit dem angegebenen event aufgerufen, wenn eine Drag&Drop-Operation das Widget betritt. Wenn das Ziehen über eine gültige Abwurfstelle erfolgt (z.B. über ein Element, das Abwürfe akzeptiert), wird das Ereignis akzeptiert; andernfalls wird es ignoriert.

Siehe auch dropEvent() und startDrag().

[override virtual protected] void QAbstractItemView::dragLeaveEvent(QDragLeaveEvent *event)

Reimplements: QAbstractScrollArea::dragLeaveEvent(QDragLeaveEvent *event).

Diese Funktion wird aufgerufen, wenn das gezogene Element die Ansicht verlässt. Die Seite event beschreibt den Zustand des Drag&Drop-Vorgangs.

[override virtual protected] void QAbstractItemView::dragMoveEvent(QDragMoveEvent *event)

Reimplements: QAbstractScrollArea::dragMoveEvent(QDragMoveEvent *event).

Diese Funktion wird während einer Drag&Drop-Operation über das Widget kontinuierlich mit dem angegebenen event aufgerufen. Sie kann dazu führen, dass die Ansicht gescrollt wird, wenn der Benutzer z.B. eine Auswahl an den rechten oder unteren Rand der Ansicht zieht. In diesem Fall wird das Ereignis akzeptiert, andernfalls wird es ignoriert.

Siehe auch dropEvent() und startDrag().

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

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

Diese Funktion wird mit der angegebenen event aufgerufen, wenn ein Drop-Ereignis über dem Widget auftritt. Wenn das Modell die gerade Position akzeptiert, wird das Drop-Ereignis angenommen; andernfalls wird es ignoriert.

Siehe auch startDrag().

[protected] QAbstractItemView::DropIndicatorPosition QAbstractItemView::dropIndicatorPosition() const

Gibt die Position des Abwurfindikators in Bezug auf das nächstgelegene Element zurück.

[slot] void QAbstractItemView::edit(const QModelIndex &index)

Beginnt mit der Bearbeitung des Elements, das dem angegebenen index entspricht, sofern es bearbeitbar ist.

Beachten Sie, dass diese Funktion den aktuellen Index nicht ändert. Da der aktuelle Index die nächsten und vorherigen zu bearbeitenden Elemente definiert, kann es vorkommen, dass die Tastaturnavigation nicht wie erwartet funktioniert. Um ein einheitliches Navigationsverhalten zu gewährleisten, rufen Sie setCurrentIndex() vor dieser Funktion mit demselben Modellindex auf.

Siehe auch QModelIndex::flags().

[virtual protected] bool QAbstractItemView::edit(const QModelIndex &index, QAbstractItemView::EditTrigger trigger, QEvent *event)

Beginnt mit der Bearbeitung des Elements unter index, erstellt bei Bedarf einen Editor und gibt true zurück, wenn die Ansicht State jetzt EditingState ist; andernfalls wird false zurückgegeben.

Die Aktion, die den Bearbeitungsprozess ausgelöst hat, wird durch trigger beschrieben, und das zugehörige Ereignis wird durch event angegeben.

Die Bearbeitung kann erzwungen werden, indem die trigger als QAbstractItemView::AllEditTriggers angegeben wird.

Siehe auch closeEditor().

[virtual protected slot] void QAbstractItemView::editorDestroyed(QObject *editor)

Diese Funktion wird aufgerufen, wenn die angegebene editor zerstört wurde.

Siehe auch closeEditor().

[signal] void QAbstractItemView::entered(const QModelIndex &index)

Dieses Signal wird ausgegeben, wenn der Mauszeiger das durch index angegebene Element erreicht. Damit diese Funktion funktioniert, muss die Mausverfolgung aktiviert sein.

Siehe auch viewportEntered(), activated(), clicked(), doubleClicked(), und pressed().

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

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

[override virtual protected] bool QAbstractItemView::eventFilter(QObject *object, QEvent *event)

Reimplements: QObject::eventFilter(QObject *watched, QEvent *event).

[protected] void QAbstractItemView::executeDelayedItemsLayout()

Führt die geplanten Layouts aus, ohne auf den Beginn der Ereignisverarbeitung zu warten.

Siehe auch scheduleDelayedItemsLayout().

[override virtual protected] void QAbstractItemView::focusInEvent(QFocusEvent *event)

Reimplements: QWidget::focusInEvent(QFocusEvent *event).

Diese Funktion wird mit dem angegebenen event aufgerufen, wenn das Widget den Fokus erhält. Standardmäßig wird das Ereignis ignoriert.

Siehe auch setFocus() und focusOutEvent().

[override virtual protected] bool QAbstractItemView::focusNextPrevChild(bool next)

Reimplements: QWidget::focusNextPrevChild(bool next).

[override virtual protected] void QAbstractItemView::focusOutEvent(QFocusEvent *event)

Reimplements: QWidget::focusOutEvent(QFocusEvent *event).

Diese Funktion wird mit dem angegebenen event aufgerufen, wenn das Widget den Fokus verliert. Standardmäßig wird das Ereignis ignoriert.

Siehe auch clearFocus() und focusInEvent().

[pure virtual protected] int QAbstractItemView::horizontalOffset() const

Gibt den horizontalen Versatz der Ansicht zurück.

In der Basisklasse ist dies eine rein virtuelle Funktion.

Siehe auch verticalOffset().

[pure virtual] QModelIndex QAbstractItemView::indexAt(const QPoint &point) const

Gibt den Modellindex des Elements an den Ansichtsfensterkoordinaten point zurück.

In der Basisklasse ist dies eine rein virtuelle Funktion.

Siehe auch visualRect().

QWidget *QAbstractItemView::indexWidget(const QModelIndex &index) const

Liefert das Widget für das Element unter der angegebenen Adresse index.

Siehe auch setIndexWidget().

[virtual protected, since 6.0] void QAbstractItemView::initViewItemOption(QStyleOptionViewItem *option) const

Initialisieren Sie die Struktur option mit der Palette, der Schriftart, dem Status, den Ausrichtungen usw. der Ansicht.

Diese Funktion wurde in Qt 6.0 eingeführt.

[override virtual protected] void QAbstractItemView::inputMethodEvent(QInputMethodEvent *event)

Reimplements: QWidget::inputMethodEvent(QInputMethodEvent *event).

[override virtual] QVariant QAbstractItemView::inputMethodQuery(Qt::InputMethodQuery query) const

Reimplements: QWidget::inputMethodQuery(Qt::InputMethodQuery query) const.

[pure virtual protected] bool QAbstractItemView::isIndexHidden(const QModelIndex &index) const

Gibt true zurück, wenn das Element, auf das die angegebene index verweist, in der Ansicht ausgeblendet ist, andernfalls gibt sie false zurück.

Ausblenden ist eine ansichtsspezifische Funktion. Zum Beispiel kann in TableView eine Spalte als ausgeblendet markiert werden oder eine Zeile in der TreeView.

In der Basisklasse ist dies eine rein virtuelle Funktion.

bool QAbstractItemView::isPersistentEditorOpen(const QModelIndex &index) const

Gibt zurück, ob für das Element mit dem Index index ein persistenter Editor geöffnet ist.

Siehe auch openPersistentEditor() und closePersistentEditor().

QAbstractItemDelegate *QAbstractItemView::itemDelegate() const

Gibt den von dieser Ansicht und diesem Modell verwendeten Elementdelegaten zurück. Es handelt sich entweder um den mit setItemDelegate() festgelegten Delegaten oder um den Standarddelegaten.

Siehe auch setItemDelegate().

QAbstractItemDelegate *QAbstractItemView::itemDelegateForColumn(int column) const

Gibt den von dieser Ansicht und diesem Modell verwendeten Elementdelegaten für den angegebenen column zurück. Sie können itemDelegate() aufrufen, um einen Zeiger auf den aktuellen Delegaten für einen gegebenen Index zu erhalten.

Siehe auch setItemDelegateForColumn(), itemDelegateForRow(), und itemDelegate().

[virtual, since 6.0] QAbstractItemDelegate *QAbstractItemView::itemDelegateForIndex(const QModelIndex &index) const

Liefert den von dieser Ansicht und diesem Modell verwendeten Elementdelegaten für die angegebene index.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch setItemDelegate(), setItemDelegateForRow(), und setItemDelegateForColumn().

QAbstractItemDelegate *QAbstractItemView::itemDelegateForRow(int row) const

Gibt den von dieser Ansicht und diesem Modell für den angegebenen row verwendeten Elementdelegaten zurück, oder nullptr wenn kein Delegat zugewiesen wurde. Sie können itemDelegate() aufrufen, um einen Zeiger auf den aktuellen Delegaten für einen gegebenen Index zu erhalten.

Siehe auch setItemDelegateForRow(), itemDelegateForColumn(), und setItemDelegate().

[override virtual protected] void QAbstractItemView::keyPressEvent(QKeyEvent *event)

Reimplements: QAbstractScrollArea::keyPressEvent(QKeyEvent *e).

Diese Funktion wird mit der angegebenen event aufgerufen, wenn ein Tastenereignis an das Widget gesendet wird. Die Standardimplementierung behandelt grundlegende Cursorbewegungen, z.B. Up, Down, Left, Right, Home, PageUp und PageDown; das Signal activated() wird ausgegeben, wenn der aktuelle Index gültig ist und die Aktivierungstaste gedrückt wird (z.B. Enter oder Return, abhängig von der Plattform). Bei dieser Funktion wird die Bearbeitung durch Tastendruck eingeleitet, z.B. wenn F2 gedrückt wird.

Siehe auch edit(), moveCursor(), keyboardSearch(), und tabKeyNavigation.

[virtual] void QAbstractItemView::keyboardSearch(const QString &search)

Bewegt sich zu dem Element, das der Zeichenfolge search am besten entspricht, und wählt es aus. Wenn kein Element gefunden wird, geschieht nichts.

In der Standardimplementierung wird die Suche zurückgesetzt, wenn search leer ist oder das Zeitintervall seit der letzten Suche QApplication::keyboardInputInterval() überschritten hat.

QAbstractItemModel *QAbstractItemView::model() const

Gibt das Modell zurück, das diese Ansicht präsentiert.

Siehe auch setModel().

[override virtual protected] void QAbstractItemView::mouseDoubleClickEvent(QMouseEvent *event)

Reimplements: QAbstractScrollArea::mouseDoubleClickEvent(QMouseEvent *e).

Diese Funktion wird mit dem angegebenen event aufgerufen, wenn eine Maustaste innerhalb des Widgets doppelt geklickt wird. Wenn der Doppelklick auf ein gültiges Element erfolgt, gibt sie das Signal doubleClicked() aus und ruft edit() für das Element auf.

[override virtual protected] void QAbstractItemView::mouseMoveEvent(QMouseEvent *event)

Reimplements: QAbstractScrollArea::mouseMoveEvent(QMouseEvent *e).

Diese Funktion wird mit der angegebenen event aufgerufen, wenn ein Mausbewegungsereignis an das Widget gesendet wird. Wenn eine Auswahl im Gange ist und neue Elemente darüber bewegt werden, wird die Auswahl erweitert; wenn ein Ziehen im Gange ist, wird sie fortgesetzt.

[override virtual protected] void QAbstractItemView::mousePressEvent(QMouseEvent *event)

Reimplements: QAbstractScrollArea::mousePressEvent(QMouseEvent *e).

Diese Funktion wird mit der angegebenen event aufgerufen, wenn eine Maustaste gedrückt wird, während sich der Cursor innerhalb des Widgets befindet. Wenn ein gültiges Element gedrückt wird, wird es zum aktuellen Element gemacht. Diese Funktion gibt das Signal pressed() aus.

[override virtual protected] void QAbstractItemView::mouseReleaseEvent(QMouseEvent *event)

Reimplements: QAbstractScrollArea::mouseReleaseEvent(QMouseEvent *e).

Diese Funktion wird mit der angegebenen event aufgerufen, wenn eine Maustaste losgelassen wird, nachdem ein Mausdruckereignis auf dem Widget stattgefunden hat. Wenn ein Benutzer die Maus innerhalb Ihres Widgets drückt und dann die Maus an eine andere Stelle zieht, bevor er die Maustaste loslässt, empfängt Ihr Widget das Loslass-Ereignis. Die Funktion gibt das Signal clicked() aus, wenn ein Element gedrückt wurde.

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

Gibt ein QModelIndex Objekt zurück, das auf das nächste Objekt in der Ansicht verweist, basierend auf dem angegebenen cursorAction und den durch modifiers spezifizierten Tastaturmodifikatoren.

In der Basisklasse ist dies eine rein virtuelle Funktion.

void QAbstractItemView::openPersistentEditor(const QModelIndex &index)

Öffnet einen dauerhaften Editor für das Element unter der angegebenen Adresse index. Wenn kein Editor existiert, erstellt der Delegierte einen neuen Editor.

Siehe auch closePersistentEditor() und isPersistentEditorOpen().

[signal] void QAbstractItemView::pressed(const QModelIndex &index)

Dieses Signal wird ausgesendet, wenn eine Maustaste gedrückt wird. Das Element, auf das die Maus gedrückt wurde, wird durch index angegeben. Das Signal wird nur ausgegeben, wenn der Index gültig ist.

Verwenden Sie die Funktion QGuiApplication::mouseButtons(), um den Zustand der Maustasten abzufragen.

Siehe auch activated(), clicked(), doubleClicked(), und entered().

[virtual slot] void QAbstractItemView::reset()

Setzt den internen Zustand der Ansicht zurück.

[override virtual protected] void QAbstractItemView::resizeEvent(QResizeEvent *event)

Reimplements: QAbstractScrollArea::resizeEvent(QResizeEvent *event).

Diese Funktion wird mit der angegebenen event aufgerufen, wenn ein Größenänderungsereignis an das Widget gesendet wird.

Siehe auch QWidget::resizeEvent().

QModelIndex QAbstractItemView::rootIndex() const

Gibt den Modellindex des Wurzelelements des Modells zurück. Das Stammelement ist das übergeordnete Element der Toplevel-Elemente der Ansicht. Die Wurzel kann ungültig sein.

Siehe auch setRootIndex().

[virtual protected slot] void QAbstractItemView::rowsAboutToBeRemoved(const QModelIndex &parent, int start, int end)

Dieser Slot wird aufgerufen, wenn Zeilen entfernt werden sollen. Die gelöschten Zeilen sind die Zeilen unter dem angegebenen parent von start bis einschließlich end.

Siehe auch rowsInserted().

[virtual protected slot] void QAbstractItemView::rowsInserted(const QModelIndex &parent, int start, int end)

Dieser Slot wird aufgerufen, wenn Zeilen eingefügt werden. Die neuen Zeilen sind die unter dem angegebenen parent von start bis einschließlich end. Die Implementierung der Basisklasse ruft fetchMore() für das Modell auf, um nach weiteren Daten zu suchen.

Siehe auch rowsAboutToBeRemoved().

[protected] void QAbstractItemView::scheduleDelayedItemsLayout()

Plant ein Layout der Elemente in der Ansicht, das ausgeführt wird, wenn die Ereignisverarbeitung beginnt.

Auch wenn scheduleDelayedItemsLayout() mehrmals vor der Ereignisverarbeitung aufgerufen wird, führt die Ansicht das Layout nur einmal aus.

Siehe auch executeDelayedItemsLayout().

[protected] void QAbstractItemView::scrollDirtyRegion(int dx, int dy)

Bereitet die Ansicht für das Scrollen um (dx,dy) Pixel vor, indem die verschmutzten Bereiche in die entgegengesetzte Richtung verschoben werden. Sie müssen diese Funktion nur aufrufen, wenn Sie ein scrollendes Ansichtsfenster in Ihrer View-Unterklasse implementieren.

Wenn Sie scrollContentsBy() in einer Unterklasse von QAbstractItemView implementieren, rufen Sie diese Funktion auf, bevor Sie QWidget::scroll() für das Ansichtsfenster aufrufen. Alternativ können Sie auch einfach update() aufrufen.

Siehe auch scrollContentsBy(), dirtyRegionOffset(), und setDirtyRegion().

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

Scrollt die Ansicht, falls erforderlich, um sicherzustellen, dass das Element auf index sichtbar ist. Die Ansicht wird versuchen, das Element entsprechend der angegebenen hint zu positionieren.

In der Basisklasse ist dies eine rein virtuelle Funktion.

[slot] void QAbstractItemView::scrollToBottom()

Scrollt die Ansicht nach unten.

Siehe auch scrollTo() und scrollToTop().

[slot] void QAbstractItemView::scrollToTop()

Blättert die Ansicht nach oben.

Siehe auch scrollTo() und scrollToBottom().

[virtual slot] void QAbstractItemView::selectAll()

Wählt alle Elemente in der Ansicht aus. Diese Funktion verwendet beim Auswählen das in der Ansicht eingestellte Auswahlverhalten.

Siehe auch setSelection(), selectedIndexes(), und clearSelection().

[virtual protected] QModelIndexList QAbstractItemView::selectedIndexes() const

Diese Komfortfunktion gibt eine Liste aller ausgewählten und nicht ausgeblendeten Elementindizes in der Ansicht zurück. Die Liste enthält keine Duplikate und ist nicht sortiert.

Siehe auch QItemSelectionModel::selectedIndexes().

[virtual protected slot] void QAbstractItemView::selectionChanged(const QItemSelection &selected, const QItemSelection &deselected)

Dieser Slot wird aufgerufen, wenn die Auswahl geändert wird. Die vorherige Auswahl (die leer sein kann) wird durch deselected angegeben, die neue Auswahl durch selected.

Siehe auch setSelection().

[virtual protected] QItemSelectionModel::SelectionFlags QAbstractItemView::selectionCommand(const QModelIndex &index, const QEvent *event = nullptr) const

Gibt die SelectionFlags zurück, die bei der Aktualisierung eines Auswahlmodells für das angegebene index verwendet werden sollen. Das Ergebnis ist abhängig vom aktuellen selectionMode() und vom Benutzereingabeereignis event, das nullptr sein kann.

Reimplementieren Sie diese Funktion, um Ihr eigenes Auswahlverhalten zu definieren.

Siehe auch setSelection().

QItemSelectionModel *QAbstractItemView::selectionModel() const

Gibt das aktuelle Auswahlmodell zurück.

Siehe auch setSelectionModel() und selectedIndexes().

[slot] void QAbstractItemView::setCurrentIndex(const QModelIndex &index)

Setzt das aktuelle Element auf das Element unter index.

Sofern der aktuelle Auswahlmodus nicht NoSelection ist, wird das Element ebenfalls ausgewählt. Beachten Sie, dass diese Funktion auch die Startposition für alle neuen Auswahlen des Benutzers aktualisiert.

Um ein Element als aktuelles Element zu setzen, ohne es auszuwählen, rufen Sie

selectionModel()->setCurrentIndex(index, QItemSelectionModel::NoUpdate);

Siehe auch currentIndex(), currentChanged(), und selectionMode.

[protected] void QAbstractItemView::setDirtyRegion(const QRegion &region)

Markiert die angegebene region als schmutzig und plant ihre Aktualisierung. Sie müssen diese Funktion nur aufrufen, wenn Sie Ihre eigene View-Unterklasse implementieren.

Siehe auch scrollDirtyRegion() und dirtyRegionOffset().

void QAbstractItemView::setIndexWidget(const QModelIndex &index, QWidget *widget)

Setzt das angegebene widget auf das Element am angegebenen index und übergibt den Besitz des Widgets an das Ansichtsfenster.

Wenn index ungültig ist (z.B. wenn Sie den Wurzelindex übergeben), wird diese Funktion nichts tun.

Die Eigenschaft autoFillBackground des angegebenen widget muss auf true gesetzt werden, andernfalls wird der Hintergrund des Widgets transparent sein und sowohl die Modelldaten als auch das Element am angegebenen index zeigen.

setIndexWidget(index, new QLineEdit);
...
setIndexWidget(index, new QTextEdit);

Diese Funktion sollte nur verwendet werden, um statische Inhalte innerhalb des sichtbaren Bereichs anzuzeigen, der einem Datenelement entspricht. Wenn Sie benutzerdefinierte dynamische Inhalte anzeigen oder ein benutzerdefiniertes Editor-Widget implementieren möchten, sollten Sie stattdessen die Unterklasse QStyledItemDelegate verwenden.

Siehe auch indexWidget() und Delegate Classes.

void QAbstractItemView::setItemDelegate(QAbstractItemDelegate *delegate)

Legt den Elementdelegierten für diese Ansicht und ihr Modell auf delegate fest. Dies ist nützlich, wenn Sie die vollständige Kontrolle über die Bearbeitung und Anzeige von Elementen haben möchten.

Jeder vorhandene Delegat wird entfernt, aber nicht gelöscht. QAbstractItemView übernimmt nicht das Eigentum an delegate.

Siehe auch itemDelegate().

void QAbstractItemView::setItemDelegateForColumn(int column, QAbstractItemDelegate *delegate)

Legt das angegebene Element delegate fest, das von dieser Ansicht und diesem Modell für das angegebene column verwendet wird. Alle Elemente auf column werden von delegate gezeichnet und verwaltet, anstatt den Standarddelegierten zu verwenden (d.h. itemDelegate()).

Jeder existierende Spaltendelegat für column wird entfernt, aber nicht gelöscht. QAbstractItemView übernimmt nicht den Besitz von delegate.

Siehe auch itemDelegateForColumn(), setItemDelegateForRow(), und itemDelegate().

void QAbstractItemView::setItemDelegateForRow(int row, QAbstractItemDelegate *delegate)

Legt das angegebene Element delegate fest, das von dieser Ansicht und diesem Modell für das angegebene row verwendet wird. Alle Elemente auf row werden von delegate gezeichnet und verwaltet, anstatt den Standarddelegierten zu verwenden (d.h. itemDelegate()).

Jeder existierende Zeilendelegat für row wird entfernt, aber nicht gelöscht. QAbstractItemView übernimmt nicht den Besitz von delegate.

Siehe auch itemDelegateForRow(), setItemDelegateForColumn(), und itemDelegate().

[virtual] void QAbstractItemView::setModel(QAbstractItemModel *model)

Setzt die model für die zu präsentierende Ansicht.

Diese Funktion erstellt und setzt ein neues Selektionsmodell und ersetzt alle Modelle, die zuvor mit setSelectionModel() gesetzt wurden. Das alte Selektionsmodell wird jedoch nicht gelöscht, da es möglicherweise von mehreren Ansichten gemeinsam genutzt wird. Wir empfehlen Ihnen, das alte Selektionsmodell zu löschen, wenn es nicht mehr benötigt wird. Dies geschieht mit folgendem Code:

QItemSelectionModel *m = view->selectionModel();
view->setModel(new model);
delete m;

Wenn sowohl das alte Modell als auch das alte Selektionsmodell keine Eltern haben oder wenn ihre Eltern langlebige Objekte sind, ist es möglicherweise besser, ihre deleteLater()-Funktionen aufzurufen, um sie explizit zu löschen.

Die Ansicht ist nur dann Eigentümer des Modells, wenn sie das Elternobjekt des Modells ist, da das Modell von vielen verschiedenen Ansichten gemeinsam genutzt werden kann.

Siehe auch model(), selectionModel(), und setSelectionModel().

[virtual slot] void QAbstractItemView::setRootIndex(const QModelIndex &index)

Setzt das Wurzelelement auf das Element unter der angegebenen Adresse index.

Siehe auch rootIndex().

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

Wendet die Auswahl flags auf die Elemente an, die sich im Rechteck rect befinden oder von diesem berührt werden.

Bei der Implementierung Ihrer eigenen Elementansicht sollte setSelection selectionModel()->select(selection, flags) aufrufen, wobei selection entweder ein leeres QModelIndex oder ein QItemSelection ist, das alle Elemente enthält, die in rect enthalten sind.

Siehe auch selectionCommand() und selectedIndexes().

[virtual] void QAbstractItemView::setSelectionModel(QItemSelectionModel *selectionModel)

Setzt das aktuelle Auswahlmodell auf das angegebene selectionModel.

Beachten Sie, dass, wenn Sie setModel() nach dieser Funktion aufrufen, das angegebene selectionModel durch ein von der Ansicht erstelltes Modell ersetzt wird.

Siehe auch selectionModel(), setModel(), und clearSelection().

[protected] void QAbstractItemView::setState(QAbstractItemView::State state)

Setzt den Zustand der Artikelansicht auf den angegebenen state.

Siehe auch state().

[virtual] int QAbstractItemView::sizeHintForColumn(int column) const

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

Diese Funktion wird in Ansichten mit einer horizontalen Kopfzeile verwendet, um den Größenhinweis für einen Kopfzeilenabschnitt basierend auf dem Inhalt der angegebenen column zu finden.

Siehe auch sizeHintForRow().

QSize QAbstractItemView::sizeHintForIndex(const QModelIndex &index) const

Gibt den Größenhinweis für das Element mit dem angegebenen index oder eine ungültige Größe für ungültige Indizes zurück.

Siehe auch sizeHintForRow() und sizeHintForColumn().

[virtual] int QAbstractItemView::sizeHintForRow(int row) const

Gibt den Größenhinweis für das angegebene row zurück oder -1, wenn es kein Modell gibt.

Die zurückgegebene Höhe wird anhand der Größenhinweise der Elemente des angegebenen row berechnet, d. h. der zurückgegebene Wert ist die maximale Höhe der Elemente. Beachten Sie, dass Sie zur Steuerung der Höhe einer Zeile die Funktion QAbstractItemDelegate::sizeHint() neu implementieren müssen.

Diese Funktion wird in Ansichten mit einer vertikalen Kopfzeile verwendet, um den Größenhinweis für einen Kopfzeilenabschnitt basierend auf dem Inhalt der angegebenen row zu finden.

Siehe auch sizeHintForColumn().

[virtual protected] void QAbstractItemView::startDrag(Qt::DropActions supportedActions)

Startet einen Drag durch Aufruf von drag->exec() unter Verwendung der angegebenen supportedActions.

[protected] QAbstractItemView::State QAbstractItemView::state() const

Gibt den Zustand der Artikelansicht zurück.

Siehe auch setState().

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

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

Diese Funktion wird mit der angegebenen event aufgerufen, wenn ein Timer-Ereignis an das Widget gesendet wird.

Siehe auch QObject::timerEvent().

[slot] void QAbstractItemView::update(const QModelIndex &index)

Aktualisiert die Fläche, die von der angegebenen index belegt wird.

[virtual protected slot] void QAbstractItemView::updateGeometries()

Aktualisiert die Geometrie der untergeordneten Widgets der Ansicht.

[pure virtual protected] int QAbstractItemView::verticalOffset() const

Gibt den vertikalen Versatz der Ansicht zurück.

In der Basisklasse ist dies eine rein virtuelle Funktion.

Siehe auch horizontalOffset().

[signal] void QAbstractItemView::viewportEntered()

Dieses Signal wird ausgegeben, wenn der Mauszeiger in das Ansichtsfenster eintritt. Damit diese Funktion funktioniert, muss die Mausverfolgung aktiviert sein.

Siehe auch entered().

[override virtual protected] bool QAbstractItemView::viewportEvent(QEvent *event)

Reimplements: QAbstractScrollArea::viewportEvent(QEvent *event).

Diese Funktion wird verwendet, um Tooltips und den "What's This?"-Modus zu behandeln, wenn das angegebene event ein QEvent::ToolTip oder ein QEvent::WhatsThis ist. Sie übergibt alle anderen Ereignisse an den Handler ihrer Basisklasse viewportEvent().

Gibt true zurück, wenn event erkannt und verarbeitet wurde; andernfalls gibt sie false zurück.

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

Reimplements: QAbstractScrollArea::viewportSizeHint() const.

[pure virtual] QRect QAbstractItemView::visualRect(const QModelIndex &index) const

Gibt das Rechteck im Ansichtsfenster zurück, das von dem Element unter index eingenommen wird.

Wenn Ihr Element in mehreren Bereichen angezeigt wird, sollte visualRect den primären Bereich zurückgeben, der index enthält, und nicht den gesamten Bereich, den index möglicherweise umfasst, berührt oder zum Zeichnen führt.

In der Basisklasse ist dies eine rein virtuelle Funktion.

Siehe auch indexAt() und visualRegionForSelection().

[pure virtual protected] QRegion QAbstractItemView::visualRegionForSelection(const QItemSelection &selection) const

Liefert den Bereich aus dem Ansichtsfenster der Elemente in der angegebenen selection.

In der Basisklasse ist dies eine rein virtuelle Funktion.

Siehe auch visualRect() und selectedIndexes().