QStyledItemDelegate Class

QItemEditorFactory *editorFactory = new QItemEditorFactory;
QItemEditorCreatorBase *creator = new QStandardItemEditorCreator<MyFancyDateTimeEdit>();
editorFactory->registerEditor(QMetaType::QDateTime, creator);

QItemEditorFactory::setDefaultFactory(editorFactory);

Dokumentation der Mitgliedsfunktionen

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

Konstruiert einen Item-Delegaten mit dem angegebenen parent.

[virtual noexcept] QStyledItemDelegate::~QStyledItemDelegate()

Zerstört den Objektdelegaten.

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

Reimplements: 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 der Stil option werden verwendet, um zu steuern, wie das Editor-Widget erscheint.

Siehe auch QAbstractItemDelegate::createEditor().

[virtual] QString QStyledItemDelegate::displayText(const QVariant &value, const QLocale &locale) const

Diese Funktion gibt die Zeichenkette zurück, die der Delegierte verwenden wird, um die Qt::DisplayRole des Modells in locale anzuzeigen. value ist der Wert des Qt::DisplayRole, der vom Modell bereitgestellt wird.

Die Standardimplementierung verwendet QLocale::toString, um value in QString umzuwandeln.

Diese Funktion wird nicht für leere Modellindizes aufgerufen, d.h. für Indizes, für die das Modell einen ungültigen QVariant zurückgibt.

Siehe auch QAbstractItemModel::data().

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

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

[override virtual protected] bool QStyledItemDelegate::eventFilter(QObject *editor, QEvent *event)

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

Gibt true zurück, wenn das angegebene editor ein gültiges QWidget ist und das angegebene event behandelt wird; andernfalls gibt es false zurück. Die folgenden Tastendruck-Ereignisse werden standardmäßig behandelt:

• Tab
• Backtab
• Enter
• Return
• Esc

Wenn der Typ von editor QTextEdit oder QPlainTextEdit ist, werden die Tasten Tab, Backtab, Enter und Return nicht behandelt.

Bei den Ereignissen Tab, Backtab, Enter und Return werden die Daten von editor in das Modell übernommen und der Editor wird geschlossen. Wenn event ein Tab Tastendruck ist, öffnet die Ansicht einen Editor für das nächste Element in der Ansicht. Handelt es sich bei event um einen Backtab Tastendruck, öffnet die Ansicht einen Editor für das vorherige Element in der Ansicht.

Handelt es sich bei dem Ereignis um einen Esc Tastendruck, wird die editor geschlossen , ohne dass die Daten übernommen werden.

Siehe auch commitData() und closeEditor().

[virtual protected] void QStyledItemDelegate::initStyleOption(QStyleOptionViewItem *option, const QModelIndex &index) const

Initialisieren Sie option mit den Werten über den Index index. Diese Methode ist für Unterklassen nützlich, wenn sie eine QStyleOptionViewItem benötigen, aber nicht alle Informationen selbst eingeben wollen.

Siehe auch QStyleOption::initFrom().

QItemEditorFactory *QStyledItemDelegate::itemEditorFactory() const

Gibt die vom Elementdelegaten verwendete Editorfabrik zurück. Wenn keine Editorfabrik gesetzt ist, gibt die Funktion null zurück.

Siehe auch setItemEditorFactory().

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

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

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

Diese Funktion malt das Element unter Verwendung der QStyle der Ansicht.

Bei der Neuimplementierung von paint in einer Unterklasse. Verwenden Sie initStyleOption(), um option auf dieselbe Weise wie QStyledItemDelegate einzurichten.

Wann immer möglich, verwenden Sie die option während des Malens. Insbesondere die Variable rect, um zu entscheiden, wo gezeichnet werden soll, und die Variable state, um festzustellen, ob sie aktiviert oder ausgewählt ist.

Nach dem Malen sollten Sie sicherstellen, dass der Painter in den Zustand zurückversetzt wird, in dem er beim Aufruf dieser Funktion geliefert wurde. Es kann zum Beispiel sinnvoll sein, QPainter::save() vor dem Malen und QPainter::restore() danach aufzurufen.

Siehe auch QItemDelegate::paint(), QStyle::drawControl(), und QStyle::CE_ItemViewItem.

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

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

Legt die vom editor anzuzeigenden und zu bearbeitenden Daten aus dem vom Model index angegebenen Datenmodellelement fest.

Die Standardimplementierung speichert die Daten in der Benutzereigenschaft des Widgets editor.

Siehe auch QMetaProperty::isUser().

void QStyledItemDelegate::setItemEditorFactory(QItemEditorFactory *factory)

Legt die vom Elementdelegierten zu verwendende Editorfabrik auf die angegebene factory fest. Wenn keine Editorfabrik festgelegt ist, verwendet der Elementdelegierte die Standard-Editorfabrik.

Siehe auch itemEditorFactory().

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

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

Holt Daten aus dem Widget editor und speichert sie im angegebenen model unter dem Element index.

Die Standardimplementierung bezieht den im Datenmodell zu speichernden Wert aus der Benutzereigenschaft des editor Widgets.

Siehe auch QMetaProperty::isUser().

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

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

Gibt die Größe zurück, die der Delegierte benötigt, um das durch index angegebene Element anzuzeigen, wobei die durch option bereitgestellten Stilinformationen berücksichtigt werden.

Diese Funktion verwendet die QStyle der Ansicht, um die Größe des Elements zu bestimmen.

Siehe auch QStyle::sizeFromContents() und QStyle::CT_ItemViewItem.

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

Reimplements: 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.