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

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

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

この関数は、空のモデルインデックス、つまりモデルが無効な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 *editor, QEvent *event)

再実装：QObject::eventFilter(QObject *watched, QEvent *event)。

与えられたeditor が有効なQWidget であり、与えられたevent が処理される場合はtrue を返し、そうでない場合はfalse を返す。デフォルトでは、以下のキー押下イベントが処理される：

• Tab
• Backtab
• Enter
• Return
• Esc

editor のタイプがQTextEdit またはQPlainTextEdit の場合、Tab 、Backtab 、Enter 、Return のキーは処理されない。

Tab 、Backtab 、Enter 、Return キー押下イベントの場合、editor のデータはモデルにコミットされ、エディタは閉じられます。event がTab キー押下の場合、ビューはビュー内の次のアイテムのエディタを開きます。同様に、event がBacktab キーの押下である場合、ビューはビューの前のアイテムのエディタを開きます。

イベントがEsc キー押下イベントの場合、editor はデータをコミットせずに閉じられます。

commitData() とcloseEditor()も参照してください 。

[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 を再実装する場合。QStyledItemDelegate と同じようにoption を設定するにはinitStyleOption() を使用します。

ペイント中は、可能な限り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 ウィジェットのユーザ・プロパティにデータを格納します。

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 ウィジェットのユーザ・プロパティからデータモデルに格納する値を取得します。

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.

与えられたスタイルoption に従ってindex で指定されたアイテムのeditor を更新します。