QAbstractItemView Class

Dokumentation zu den Member-Funktionen

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

Erstellt eine abstrakte Elementansicht mit dem angegebenen „ parent “.

[virtual noexcept] QAbstractItemView::~QAbstractItemView()

Das ruiniert die Aussicht.

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

Dieses Signal wird ausgelöst, wenn das durch „ index “ angegebene Element vom Benutzer aktiviert wird. Wie Elemente aktiviert werden, hängt von der jeweiligen Plattform ab; beispielsweise durch Einfach- oder Doppelklick auf das Element oder durch Drücken der Return- oder Enter-Taste, wenn das Element aktiv ist.

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

[slot] void QAbstractItemView::clearSelection()

Hebt die Auswahl aller ausgewählten Elemente auf. Der aktuelle Index wird dabei nicht geändert.

Siehe auch setSelection() und selectAll().

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

Dieses Signal wird ausgelöst, wenn die linke Maustaste gedrückt wird. Das Element, auf das geklickt wurde, wird durch ` index` angegeben. Das Signal wird nur ausgelöst, 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 Ansicht „ editor “ und gibt sie frei. Mit dem Hinweis „ hint “ wird festgelegt, wie die Ansicht auf das Ende des Bearbeitungsvorgangs reagieren soll. Der Hinweis kann beispielsweise angeben, 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 Element unter der angegebenen Adresse index.

Siehe auch openPersistentEditor() und isPersistentEditorOpen().

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

Übernehmen Sie die Daten aus dem „ 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 zum aktuellen Element wird. Das bisherige aktuelle Element wird durch den Index „ previous “ angegeben, das neue Element durch den Index „ current “.

Wenn Sie mehr über Änderungen an Elementen erfahren möchten, lesen Sie die Beschreibung des Signals „ 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 aus dem Bereich von topLeft bis einschließlich bottomRight. Wird nur ein Element geändert, gilt: topLeft == bottomRight.

Die geänderten „ roles “ 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 geänderten Bereiche in der Ansicht zurück.

Wenn Sie ` scrollDirtyRegion()` verwenden und eine Methode ` paintEvent()` in einer Unterklasse von ` QAbstractItemView` implementieren, sollten Sie den durch das Paint-Ereignis angegebenen Bereich mit dem von dieser Funktion zurückgegebenen Offset verschieben.

Siehe auch ` scrollDirtyRegion()` und ` setDirtyRegion()`.

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

Dieses Signal wird ausgelöst, wenn ein Mausklick doppelt ausgeführt wird. Das Element, auf das doppelt geklickt wurde, wird durch ` index` angegeben. Das Signal wird nur ausgelöst, wenn der Index gültig ist.

Siehe auch „ clicked()“ und „ activated()“.

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

Umsetzung von: QAbstractScrollArea::dragEnterEvent(QDragEnterEvent *event).

Diese Funktion wird mit dem angegebenen ` event ` aufgerufen, wenn ein Drag-and-Drop-Vorgang in das Widget eintritt. Befindet sich der geziehte Gegenstand über einer gültigen Ablageposition (z. B. über einem Element, das das Ablegen akzeptiert), wird das Ereignis akzeptiert; andernfalls wird es ignoriert.

Siehe auch dropEvent() und startDrag().

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

Umsetzt: ` QAbstractScrollArea::dragLeaveEvent` (`QDragLeaveEvent *event`).

Diese Funktion wird aufgerufen, wenn das gezogene Element den Bereich verlässt. Das ` event ` beschreibt den Status des Drag-and-Drop-Vorgangs.

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

Umsetzt: ` QAbstractScrollArea::dragMoveEvent(QDragMoveEvent *event)`.

Diese Funktion wird während eines Drag-and-Drop-Vorgangs über das Widget kontinuierlich mit dem angegebenen ` event ` aufgerufen. Sie kann dazu führen, dass die Ansicht scrollt, wenn der Benutzer beispielsweise 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)

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

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

Siehe auch ` startDrag()`.

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

Gibt die Position des Ablage-Indikators relativ zum nächstgelegenen Element zurück.

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

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

Beachten Sie, dass diese Funktion den aktuellen Index nicht ändert. Da der aktuelle Index das nächste und das vorherige zu bearbeitende Element definiert, kann es vorkommen, dass die Tastaturnavigation nicht wie erwartet funktioniert. Um ein konsistentes Navigationsverhalten zu gewährleisten, rufen Sie vor dieser Funktion „ setCurrentIndex()“ mit demselben Modellindex auf.

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        abstractItemView, qOverload(&QAbstractItemView::edit));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        abstractItemView, [receiver = abstractItemView](const QModelIndex &index) { receiver->edit(index); });

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 der Wert von „ State “ der Ansicht nun EditingState lautet; andernfalls wird false zurückgegeben.

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

Die Bearbeitung kann erzwungen werden, indem für ` trigger ` der Wert ` 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 ausgelöst, wenn der Mauszeiger in das durch „ index “ angegebene Element gelangt. Damit diese Funktion genutzt werden kann, muss die Mausverfolgung aktiviert sein.

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

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

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

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

Implementiert: 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)

Umsetzt: ` 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)

Implementiert: ` QWidget::focusNextPrevChild` (bool next).

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

Umsetzt: ` 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 Viewport-Koordinaten point zurück.

In der Basisklasse ist dies eine rein virtuelle Funktion.

Siehe auch visualRect().

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

Gibt das Widget für das Element an der angegebenen Adresse index zurück.

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)

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

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

Implementiert neu: ` 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 der angegebene „ index “ verweist, in der Ansicht ausgeblendet ist; andernfalls wird „ false “ zurückgegeben.

Das Ausblenden ist eine ansichtsbezogene Funktion. Beispielsweise kann in ` TableView ` eine Spalte als ausgeblendet markiert werden oder eine Zeile in ` TreeView`.

In der Basisklasse handelt es sich hierbei um eine rein virtuelle Funktion.

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

Gibt zurück, ob für das Element am 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 Item-Delegaten zurück. Dabei handelt es sich entweder um einen mit ` setItemDelegate()` festgelegten oder um den Standard-Delegaten.

Siehe auch ` setItemDelegate()`.

QAbstractItemDelegate *QAbstractItemView::itemDelegateForColumn(int column) const

Gibt den von dieser Ansicht und diesem Modell verwendeten Element-Delegaten für die angegebene ` column` zurück. Mit dem Aufruf von ` itemDelegate()` können Sie einen Zeiger auf den aktuellen Delegaten für einen bestimmten Index abrufen.

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

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

Gibt den von dieser Ansicht und diesem Modell verwendeten Element-Delegaten für die angegebene „ index “ zurück.

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 verwendeten Element-Delegaten für den angegebenen ` row` zurück oder ` nullptr `, falls kein Delegat zugewiesen wurde. Mit dem Aufruf von ` itemDelegate()` können Sie einen Zeiger auf den aktuellen Delegaten für einen bestimmten Index abrufen.

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

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

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

Diese Funktion wird mit dem angegebenen ` event ` aufgerufen, wenn ein Tastenereignis an das Widget gesendet wird. Die Standardimplementierung übernimmt grundlegende Cursorbewegungen, z. B. Nach oben, Nach unten, Nach links, Nach rechts, Home, Bild auf und Bild ab; das Signal „ activated()“ wird ausgelöst, wenn der aktuelle Index gültig ist und die Aktivierungstaste gedrückt wird (z. B. Enter oder Return, je nach Plattform). In dieser Funktion wird die Bearbeitung durch einen Tastendruck initiiert, z. B. wenn F2 gedrückt wird.

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

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

Springt zu dem Element, das am besten mit der Zeichenfolge „ search “ übereinstimmt, und wählt es aus. Wird kein Element gefunden, geschieht nichts.

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

QAbstractItemModel *QAbstractItemView::model() const

Gibt das Modell zurück, das diese Ansicht darstellt.

Siehe auch ` setModel()`.

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

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

Diese Funktion wird mit dem angegebenen ` event ` aufgerufen, wenn innerhalb des Widgets ein Doppelklick mit der Maustaste erfolgt. Befindet sich der Doppelklick auf einem gültigen Element, sendet sie das Signal ` doubleClicked()` aus und ruft ` edit()` für das Element auf.

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

Implementiert: ` QAbstractScrollArea::mouseMoveEvent(QMouseEvent *e)`.

Diese Funktion wird mit dem angegebenen ` event ` aufgerufen, wenn ein Mausbewegungsereignis an das Widget gesendet wird. Wenn gerade eine Auswahl stattfindet und neue Elemente darüber bewegt werden, wird die Auswahl erweitert; wenn gerade ein Ziehvorgang stattfindet, wird dieser fortgesetzt.

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

Implementiert: ` QAbstractScrollArea::mousePressEvent` (QMouseEvent *e).

Diese Funktion wird mit dem angegebenen ` event ` aufgerufen, wenn eine Maustaste gedrückt wird, während sich der Cursor innerhalb des Widgets befindet. Wird ein gültiges Element gedrückt, wird dieses zum aktuellen Element gesetzt. Diese Funktion löst das Signal ` pressed()` aus.

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

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

Diese Funktion wird mit dem angegebenen ` event ` aufgerufen, wenn eine Maustaste losgelassen wird, nachdem ein Mausklick-Ereignis auf dem Widget stattgefunden hat. Wenn ein Benutzer die Maustaste innerhalb Ihres Widgets drückt und die Maus dann an eine andere Stelle zieht, bevor er die Maustaste loslässt, erhält Ihr Widget das Loslass-Ereignis. Die Funktion sendet 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 über ` modifiers` festgelegten Tastaturmodifikatoren.

In der Basisklasse ist dies eine rein virtuelle Funktion.

void QAbstractItemView::openPersistentEditor(const QModelIndex &index)

Öffnet einen persistenten Editor für das Element unter der angegebenen Adresse index. Falls noch kein Editor vorhanden ist, erstellt der Delegat einen neuen Editor.

Siehe auch „ closePersistentEditor()“ und „ isPersistentEditorOpen()“.

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

Dieses Signal wird ausgelöst, wenn eine Maustaste gedrückt wird. Das Element, auf dem die Maustaste gedrückt wurde, wird durch ` index` angegeben. Das Signal wird nur ausgelöst, wenn der Index gültig ist.

Verwenden Sie die Funktion ` QGuiApplication::mouseButtons()` (), um den Status der Maustasten abzurufen.

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)

Implementiert: ` QAbstractScrollArea::resizeEvent(QResizeEvent *event)`.

Diese Funktion wird mit dem 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 Stammelements des Modells zurück. Das Stammelement ist das übergeordnete Element der obersten Elemente der Ansicht. Das Stammelement 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. Bei den gelöschten Zeilen handelt es sich um diejenigen unter dem angegebenen parent im Bereich 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. Bei den neuen Zeilen handelt es sich um diejenigen unter dem angegebenen parent im Bereich von start bis einschließlich end. Die Implementierung der Basisklasse ruft fetchMore() für das Modell auf, um zu prüfen, ob weitere Daten vorhanden sind.

Siehe auch rowsAboutToBeRemoved().

[protected] void QAbstractItemView::scheduleDelayedItemsLayout()

Legt ein Layout der Elemente in der Ansicht fest, das zu Beginn der Ereignisverarbeitung ausgeführt werden soll.

Selbst wenn `scheduleDelayedItemsLayout()` vor der Verarbeitung der Ereignisse mehrfach aufgerufen wird, führt die Ansicht das Layout nur einmal durch.

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 geänderten Bereiche in die entgegengesetzte Richtung verschoben werden. Sie müssen diese Funktion nur aufrufen, wenn Sie in Ihrer View-Unterklasse einen scrollbaren Viewport implementieren.

Wenn Sie ` scrollContentsBy()` in einer Unterklasse von ` QAbstractItemView` implementieren, rufen Sie diese Funktion auf, bevor Sie ` QWidget::scroll()` für den Viewport 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)

Blättert die Ansicht bei Bedarf, um sicherzustellen, dass das Element unter index sichtbar ist. Die Ansicht versucht, das Element entsprechend dem angegebenen hint zu positionieren.

In der Basisklasse handelt es sich hierbei um eine rein virtuelle Funktion.

[slot] void QAbstractItemView::scrollToBottom()

Blättert die Ansicht bis zum Ende.

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 für die Ansicht festgelegte Auswahlverhalten.

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

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

Diese Hilfsfunktion 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 sich die Auswahl ändert. 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 hängt vom aktuellen „ selectionMode()“ sowie vom Benutzereingabeereignis „ event “ ab, das „ nullptr “ sein kann.

Implementieren Sie diese Funktion neu, 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 zusätzlich ausgewählt. Beachten Sie, dass diese Funktion auch die Startposition für alle neuen Auswahlen aktualisiert, die der Benutzer vornimmt.

Um ein Element als aktuelles Element festzulegen, 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 „dirty“ und plant ihre Aktualisierung ein. Sie müssen diese Funktion nur aufrufen, wenn Sie eine eigene Unterklasse der `View` implementieren.

Siehe auch ` scrollDirtyRegion()` und ` dirtyRegionOffset()`.

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

Setzt die angegebene „ widget “ für das Element an der angegebenen Position „ index “ und überträgt damit die Eigentumsrechte des Widgets an den Viewport.

Ist ` index ` ungültig (z. B. wenn der Root-Index übergeben wird), führt diese Funktion keine Aktion aus.

Die Eigenschaft „ autoFillBackground “ des angegebenen „ widget “ muss auf „true“ gesetzt sein, andernfalls ist der Hintergrund des Widgets transparent, sodass sowohl die Modelldaten als auch das Element an der angegebenen Position „ index “ angezeigt werden.

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, erstellen Sie stattdessen eine Unterklasse von ` QStyledItemDelegate `.

Siehe auch „ indexWidget()“ und „Delegate-Klassen“.

void QAbstractItemView::setItemDelegate(QAbstractItemDelegate *delegate)

Legt den Element-Delegaten 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 wünschen.

Ein eventuell vorhandener Delegat wird entfernt, jedoch nicht gelöscht. „ QAbstractItemView “ übernimmt nicht die Eigentümerschaft 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 Standard-Delegaten (d. h. itemDelegate()) zu verwenden.

Alle vorhandenen Spalten-Delegaten für column werden entfernt, jedoch nicht gelöscht. QAbstractItemView übernimmt nicht die Eigentümerschaft an 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 die angegebene „ row “ verwendet wird. Alle Elemente auf „ row “ werden von „ delegate “ gezeichnet und verwaltet, anstatt den Standard-Delegaten (d. h. „ itemDelegate()“) zu verwenden.

Ein eventuell vorhandener Zeilen-Delegat für row wird entfernt, jedoch nicht gelöscht. QAbstractItemView übernimmt nicht die Verantwortung für delegate.

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

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

Legt das Auswahlmodell „ model “ für die anzuzeigende Ansicht fest.

Diese Funktion erstellt und setzt ein neues Auswahlmodell und ersetzt damit jedes Modell, das zuvor mit ` setSelectionModel()` festgelegt wurde. Das alte Auswahlmodell wird jedoch nicht gelöscht, da es möglicherweise von mehreren Ansichten gemeinsam genutzt wird. Wir empfehlen, das alte Auswahlmodell zu löschen, wenn es nicht mehr benötigt wird. Dies geschieht mit dem folgenden Code:

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

Wenn sowohl das alte Modell als auch das alte Auswahlmodell keine übergeordneten Objekte haben oder wenn deren übergeordnete Objekte langlebige Objekte sind, kann es vorteilhaft sein, deren ` deleteLater()`-Funktionen aufzurufen, um sie explizit zu löschen.

Die Ansicht übernimmt die Eigentümerschaft am Modell nur dann, wenn sie das übergeordnete Objekt des Modells ist, da das Modell möglicherweise von vielen verschiedenen Ansichten gemeinsam genutzt wird.

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

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

Setzt das Stammelement 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 Auswahlfunktion ` flags ` auf die Elemente an, die sich innerhalb des Rechtecks befinden oder von diesem berührt werden: ` rect`.

Bei der Implementierung einer eigenen ItemView sollte `setSelection` die Methode ` 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 nach dem Aufruf dieser Funktion „ setModel()“ 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 Status der Elementansicht auf den angegebenen Wert „ state “.

Siehe auch ` state()`.

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

Gibt den Breitenhinweis für das angegebene „ column “ zurück oder -1, wenn kein Modell vorhanden ist.

Diese Funktion wird in Ansichten mit einer horizontalen Kopfzeile verwendet, um anhand des Inhalts des angegebenen ` column` den Größenhinweis für einen Kopfzeilenabschnitt zu ermitteln.

Siehe auch ` sizeHintForRow()`.

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

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

Siehe auch ` sizeHintForRow()` und ` sizeHintForColumn()`.

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

Gibt den Höhenhinweis für das angegebene „ row “ zurück oder -1, wenn kein Modell vorhanden ist.

Die zurückgegebene Höhe wird anhand der Größenhinweise der Elemente des angegebenen ` row` berechnet, d. h., der zurückgegebene Wert entspricht der maximalen Höhe unter den Elementen. 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 vertikaler Kopfzeile verwendet, um anhand des Inhalts des angegebenen ` row` den Größenhinweis für einen Kopfzeilenabschnitt zu ermitteln.

Siehe auch ` sizeHintForColumn()`.

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

Startet einen Drag-Vorgang, indem „drag->exec()“ mit dem angegebenen „ supportedActions “ aufgerufen wird.

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

Gibt den Status der Elementansicht zurück.

Siehe auch ` setState()`.

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

Umsetzt: ` QObject::timerEvent` (`QTimerEvent *event`).

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

Siehe auch QObject::timerEvent().

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

Aktualisiert den von der angegebenen „ index “ belegten Bereich.

[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 ausgelöst, wenn der Mauszeiger in den Darstellungsbereich gelangt. Damit diese Funktion genutzt werden kann, muss die Mausverfolgung aktiviert sein.

Siehe auch entered().

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

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

Diese Funktion dient zur Verarbeitung von Tooltips und des „Was ist das?“-Modus, sofern das angegebene ` event ` ein ` QEvent::ToolTip` oder ein ` QEvent::WhatsThis` ist. Alle anderen Ereignisse werden an den `viewportEvent()`-Handler der Basisklasse weitergeleitet.

Gibt „ true “ zurück, wenn „ event “ erkannt und verarbeitet wurde; andernfalls wird „ false “ zurückgegeben.

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

Implementiert: ` QAbstractScrollArea::viewportSizeHint()` const.

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

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

Wenn Ihr Element in mehreren Bereichen angezeigt wird, sollte `visualRect` den primären Bereich zurückgeben, der den Index enthält, und nicht den gesamten Bereich, den der Index möglicherweise umfasst, berührt oder in dem er eine Zeichnung verursacht.

In der Basisklasse ist dies eine rein virtuelle Funktion.

Siehe auch „ indexAt()“ und „ visualRegionForSelection()“.

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

Gibt den Bereich aus dem Ansichtsfenster der Elemente im angegebenen ` selection` zurück.

In der Basisklasse ist dies eine rein virtuelle Funktion.

Siehe auch „ visualRect()“ und „ selectedIndexes()“.