QItemDelegate Class

Dokumentation zu den Member-Funktionen

[explicit] QItemDelegate::QItemDelegate(QObject *parent = nullptr)

Erstellt einen Item-Delegaten mit dem angegebenen ` parent`.

[virtual noexcept] QItemDelegate::~QItemDelegate()

Löscht den Item-Delegaten.

[override virtual] QWidget *QItemDelegate::createEditor(QWidget *parent, const QStyleOptionViewItem &option, const QModelIndex &index) const

Implementiert: ` QAbstractItemDelegate::createEditor(QWidget *parent, const QStyleOptionViewItem &option, const QModelIndex &index) const`.

Gibt das Widget zurück, das zur Bearbeitung des durch ` index ` angegebenen Elements verwendet wird. Das Widget ` parent ` und die Stil- option dienen dazu, das Erscheinungsbild des Editor-Widgets zu steuern.

Siehe auch QAbstractItemDelegate::createEditor().

[protected] void QItemDelegate::drawBackground(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const

Zeigt den Hintergrund des Elements für die angegebene „ index “ unter Verwendung der angegebenen „ painter “ und des Stils „ option “ an.

[virtual protected] void QItemDelegate::drawCheck(QPainter *painter, const QStyleOptionViewItem &option, const QRect &rect, Qt::CheckState state) const

Zeigt ein Häkchen innerhalb des durch ` rect` angegebenen Rechtecks an, wobei die angegebenen Werte für ` painter ` und den Stil ` option` verwendet werden und die angegebene Farbe ` state` zum Einsatz kommt.

[virtual protected] void QItemDelegate::drawDecoration(QPainter *painter, const QStyleOptionViewItem &option, const QRect &rect, const QPixmap &pixmap) const

Zeigt die Dekoration „ pixmap “ innerhalb des durch „ rect “ angegebenen Rechtecks unter Verwendung der angegebenen „ painter “ und des Stils „ option “ an.

[virtual protected] void QItemDelegate::drawDisplay(QPainter *painter, const QStyleOptionViewItem &option, const QRect &rect, const QString &text) const

Zeigt die Elementansicht „ text “ innerhalb des durch „ rect “ angegebenen Rechtecks unter Verwendung der angegebenen „ painter “ und des Stils „ option “ an.

[virtual protected] void QItemDelegate::drawFocus(QPainter *painter, const QStyleOptionViewItem &option, const QRect &rect) const

Zeigt den Bereich innerhalb des durch „ rect “ angegebenen Rechtecks an, wobei deutlich gemacht wird, dass dieser den Fokus hat, und verwendet dabei die angegebenen Werte „ painter “ und „style option “.

[override virtual protected] bool QItemDelegate::editorEvent(QEvent *event, QAbstractItemModel *model, const QStyleOptionViewItem &option, const QModelIndex &index)

Umsetzt: ` QAbstractItemDelegate::editorEvent` (`QEvent *event, QAbstractItemModel *model, const QStyleOptionViewItem &option, const QModelIndex &index`).

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

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

Einzelheiten finden Sie unter QAbstractItemDelegate::handleEditorEvent().

QItemEditorFactory *QItemDelegate::itemEditorFactory() const

Gibt die vom Item-Delegaten verwendete Editor-Factory zurück. Ist keine Editor-Factory festgelegt, gibt die Funktion null zurück.

Siehe auch ` setItemEditorFactory()`.

[override virtual] void QItemDelegate::paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const

Implementiert: QAbstractItemDelegate::paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const.

Rendert den Delegaten unter Verwendung des angegebenen ` painter ` und der Stil option für das durch ` index` angegebene Element.

Wenn Sie diese Funktion in einer Unterklasse neu implementieren, sollten Sie den von der Variablen ` rect ` der Option verwalteten Bereich aktualisieren, wobei Sie die Variable ` state ` der Option verwenden, um den Zustand des anzuzeigenden Elements zu ermitteln, und die Art und Weise, wie es gezeichnet wird, entsprechend anpassen.

Beispielsweise muss ein ausgewähltes Element möglicherweise anders dargestellt werden als nicht ausgewählte Elemente, wie im folgenden Code gezeigt:

if (option.state & QStyle::State_Selected)
    painter->fillRect(option.rect, option.palette.highlight());

Nach dem Zeichnen sollten Sie sicherstellen, dass der Painter in den Zustand zurückversetzt wird, in dem er sich beim Aufruf dieser Funktion befand. So kann es beispielsweise sinnvoll sein, vor dem Zeichnen ` QPainter::save()` und danach ` QPainter::restore()` aufzurufen.

Siehe auch ` QStyle::State`.

[override virtual] void QItemDelegate::setEditorData(QWidget *editor, const QModelIndex &index) const

Umsetzt: ` QAbstractItemDelegate::setEditorData(QWidget *editor, const QModelIndex &index) const`.

Legt die Daten fest, die vom ` editor ` angezeigt und bearbeitet werden sollen, und zwar anhand des durch den Modell index en angegebenen Datenmodellelements.

Die Standardimplementierung speichert die Daten in der Benutzer-Eigenschaft des editor -Widgets.

Siehe auch ` QMetaProperty::isUser()`.

void QItemDelegate::setItemEditorFactory(QItemEditorFactory *factory)

Legt fest, dass der vom Element-Delegaten zu verwendende Editor-Factory der angegebene „ factory “ ist. Wenn kein Editor-Factory festgelegt ist, verwendet der Element-Delegat den Standard-Editor-Factory.

Siehe auch ` itemEditorFactory()`.

[override virtual] void QItemDelegate::setModelData(QWidget *editor, QAbstractItemModel *model, const QModelIndex &index) const

Implementiert neu: ` QAbstractItemDelegate::setModelData(QWidget *editor, QAbstractItemModel *model, const QModelIndex &index) const`.

Ruft Daten aus dem „ editor “-Widget ab und speichert sie im angegebenen „ model “ unter dem Element- index.

Die Standardimplementierung bezieht den im Datenmodell zu speichernden Wert aus der Benutzer-Eigenschaft des „ editor “-Widgets.

Siehe auch „ QMetaProperty::isUser()“.

[override virtual] QSize QItemDelegate::sizeHint(const QStyleOptionViewItem &option, const QModelIndex &index) const

Implementiert: ` QAbstractItemDelegate::sizeHint(const QStyleOptionViewItem &option, const QModelIndex &index) const`.

Gibt die Größe zurück, die der Delegat benötigt, um das durch ` index` angegebene Element anzuzeigen, unter Berücksichtigung der durch ` option` bereitgestellten Stilinformationen.

Beachten Sie bei der Neuimplementierung dieser Funktion, dass „ QItemDelegate “ bei Textelementen einen Rand (d. h. 2 * QStyle::PM_FocusFrameHMargin) zur Länge des Textes hinzufügt.

[override virtual] void QItemDelegate::updateEditorGeometry(QWidget *editor, const QStyleOptionViewItem &option, const QModelIndex &index) const

Implementiert: ` QAbstractItemDelegate::updateEditorGeometry(QWidget *editor, const QStyleOptionViewItem &option, const QModelIndex &index) const`.

Aktualisiert die ` editor ` für das durch ` index ` angegebene Element gemäß dem angegebenen Stil option.