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

与えられたpainter とスタイルoption を使って、与えられたindex のアイテムの背景をレンダリングします。

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

指定されたpainter とスタイルoption を用いて、rect で指定された矩形内に、指定されたstate で指定されたチェック・インジケータを描画します。

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

与えられたpainter とスタイルoption を用いて、rect で指定された矩形内に装飾pixmap をレンダリングします。

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

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

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

与えられたpainter とスタイルoption を用いて、rect で指定された矩形内の領域をレンダリングします。

[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 *editor, QEvent *event)

再インプリメント：QObject::eventFilter(QObject *watched, QEvent *event)。

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

• Tab
• Backtab
• Enter
• Return
• Esc

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

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

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

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 を使用してデリゲートをレンダリングします。

サブクラスでこの関数を再実装する場合、表示されるアイテムの状態を決定するためにオプションのstate 変数を使用して、オプションのrect 変数によって保持される領域を更新し、それに応じて描画方法を調整する必要があります。

たとえば、次のコードのように、選択された項目は、選択されていない項目とは異なる方法で表示する必要があるかもしれません：

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

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

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

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

再実装：QAbstractItemDelegate::sizeHint(const QStyleOptionViewItem &option, const QModelIndex &index) const.

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

この関数を再実装する場合、テキストアイテムの場合、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.

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