QStyledItemDelegate Class

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

QItemEditorFactory::setDefaultFactory(editorFactory);

メンバ関数のドキュメント

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

指定されたparent を使用して、アイテムデリゲートを構築します。

[virtual noexcept] QStyledItemDelegate::~QStyledItemDelegate()

アイテムデリゲートを破棄します。

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

QAbstractItemDelegate::createEditor(QWidget *parent, const QStyleOptionViewItem &option, const QModelIndex &index) const を再実装します。

index で指定された項目の編集に用いられるウィジェットを返します。エディタウィジェットの表示方法を制御するには、parent ウィジェットとスタイルoption を使用します。

QAbstractItemDelegate::createEditor()も参照してください 。

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

この関数は、デリゲートがlocale でモデルのQt::DisplayRole を表示するために使用する文字列を返します。value は、モデルから提供されるQt::DisplayRole の値です。

デフォルトの実装では、QLocale::toString を使用して、value をQString に変換します。

この関数は、空のモデルインデックス、すなわちモデルが無効なQVariant を返すインデックスに対しては呼び出されません。

QAbstractItemModel::data()も参照してください 。

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

QAbstractItemDelegate::editorEvent （QEvent *event, QAbstractItemModel *model, const QStyleOptionViewItem &option, const QModelIndex &index）を再実装します。

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

QObject::eventFilter(QObject *watched, QEvent *event) を再実装します。

詳細はQAbstractItemDelegate::handleEditorEvent() を参照してください。

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

インデックス `index` を使用して、option を初期化します。このメソッドは、サブクラスが `QStyleOptionViewItem` を必要とするものの、すべての情報を自分で設定したくない場合に役立ちます。

QStyleOption::initFrom()も参照してください 。

QItemEditorFactory *QStyledItemDelegate::itemEditorFactory() const

アイテムデリゲートで使用されるエディタファクトリを返します。エディタファクトリが設定されていない場合、この関数は null を返します。

setItemEditorFactory()も参照してください 。

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

QAbstractItemDelegate::paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const を再実装します。

index で指定されたアイテムに対して、指定されたpainter およびスタイルoption を使用してデリゲートをレンダリングします。

この関数は、ビューのQStyle を使用してアイテムを描画します。

サブクラスで paint を再実装する場合は、initStyleOption() を使用して、QStyledItemDelegate と同様にoption を設定してください。

可能な限り、描画時にはoption を使用してください。特に、描画位置を決定するためのrect 変数や、有効または選択されているかどうかを判断するためのstate を活用してください。

描画後は、この関数が呼び出された時点での状態へペインターを戻すようにしてください。例えば、描画前に `QPainter::save()` を呼び出し、描画後に `QPainter::restore()` を呼び出すと便利です。

QItemDelegate::paint()、QStyle::drawControl()、およびQStyle::CE_ItemViewItemも参照してください 。

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

QAbstractItemDelegate::setEditorData(QWidget *editor, const QModelIndex &index) const を再実装します。

モデル `index` で指定されたデータモデル項目から、editor によって表示および編集されるデータを設定します。

デフォルトの実装では、データはeditor ウィジェットのuser プロパティに格納されます。

QMetaProperty::isUser()も参照してください 。

void QStyledItemDelegate::setItemEditorFactory(QItemEditorFactory *factory)

アイテムデリゲートが使用するエディタファクトリを、指定されたfactory に設定します。エディタファクトリが設定されていない場合、アイテムデリゲートはデフォルトのエディタファクトリを使用します。

itemEditorFactory()も参照してください 。

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

QAbstractItemDelegate::setModelData(QWidget *editor, QAbstractItemModel *model, const QModelIndex &index) const を再実装します。

editor ウィジェットからデータを取得し、指定されたmodel の項目index に格納します。

デフォルトの実装では、editor ウィジェットのuserプロパティから、データモデルに格納する値を取得します。

「QMetaProperty::isUser()」も参照してください 。

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

QAbstractItemDelegate::sizeHint(const QStyleOptionViewItem &option, const QModelIndex &index) const を再実装します。

option で指定されたスタイル情報を考慮し、index で指定されたアイテムを表示するためにデリゲートが必要とするサイズを返します。

この関数は、ビューの `QStyle ` を使用して、項目のサイズを決定します。

QStyle::sizeFromContents() およびQStyle::CT_ItemViewItemも参照してください 。

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

QAbstractItemDelegate::updateEditorGeometry(QWidget *editor, const QStyleOptionViewItem &option, const QModelIndex &index) const を再実装します。

index で指定された項目のeditor を、指定されたスタイルoption に基づいて更新します。