QItemDelegate Class

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

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

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

[virtual noexcept] QItemDelegate::~QItemDelegate()

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

[override virtual] QWidget *QItemDelegate::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()も参照してください 。

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

指定されたindex に対して、指定されたpainter およびスタイルoption を使用して、項目の背景を描画します。

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

rect で指定された矩形内に、指定されたpainter およびスタイルoption を使用し、指定されたstate を用いて、チェックマークを表示します。

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

指定された `rect ` で囲まれた矩形内に、指定された `painter ` およびスタイル `option` を使用して、装飾 `pixmap ` を描画します。

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

指定された `rect ` で指定された矩形内に、指定された `painter ` およびスタイル `option` を使用して、アイテムビュー `text ` をレンダリングします。

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

rect で指定された矩形内の領域を、指定されたpainter およびスタイルoption を使用して、その領域にフォーカスがあることを示すように描画します。

[override virtual protected] bool QItemDelegate::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 QItemDelegate::eventFilter(QObject *object, QEvent *event)

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

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

QItemEditorFactory *QItemDelegate::itemEditorFactory() const

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

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

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

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

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

サブクラスでこの関数を再実装する場合、オプションの `rect ` 変数が保持する領域を更新し、オプションの `state ` 変数を使用して表示する項目の状態を判断し、それに応じて描画方法を調整する必要があります。

たとえば、次のコードに示すように、選択された項目は選択されていない項目とは異なる方法で表示する必要がある場合があります。

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

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

QStyle::Stateも参照してください 。

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

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

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

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

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

void QItemDelegate::setItemEditorFactory(QItemEditorFactory *factory)

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

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

[override virtual] void QItemDelegate::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 QItemDelegate::sizeHint(const QStyleOptionViewItem &option, const QModelIndex &index) const

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

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

この関数を再実装する際、テキスト項目の場合、QItemDelegate はテキストの長さにマージン（すなわち 2 *QStyle::PM_FocusFrameHMargin ）を追加することに注意してください。

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

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

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