QAbstractItemDelegate Class

void WidgetDelegate::paint(QPainter *painter, const QStyleOptionViewItem &option,
                           const QModelIndex &index) const
{
    if (index.column() == 1) {
        int progress = index.data().toInt();

        QStyleOptionProgressBar progressBarOption;
        progressBarOption.rect = option.rect;
        progressBarOption.minimum = 0;
        progressBarOption.maximum = 100;
        progressBarOption.progress = progress;
        progressBarOption.text = QString::number(progress) + "%";
        progressBarOption.textVisible = true;

        QApplication::style()->drawControl(QStyle::CE_ProgressBar,
                                           &progressBarOption, painter);
    } else
        QStyledItemDelegate::paint(painter, option, index);

メンバ関数ドキュメント

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

与えられたparent を持つ新しい抽象項目デリゲートを作成します。

[virtual noexcept] QAbstractItemDelegate::~QAbstractItemDelegate()

抽象項目デリゲートを破棄します。

[signal] void QAbstractItemDelegate::closeEditor(QWidget *editor, QAbstractItemDelegate::EndEditHint hint = NoHint)

このシグナルは、ユーザが指定されたeditor を使ってアイテムの編集を終了したときに発行されます。

hint は、デリゲートが編集完了後のモデルとビューの動作に影響を与える方法を提供します。これは、ユーザーに快適な編集体験を提供するために、次に実行されるべきアクションをこれらのコンポーネントに示します。例えば、EditNextItem が指定された場合、ビューはデリゲートを使用してモデルの次のアイテムのエディタを開く必要があります。

EndEditHintも参照してください 。

[signal] void QAbstractItemDelegate::commitData(QWidget *editor)

このシグナルは、editor ウィジェットがデータの編集を完了し、それをモデルに書き戻したいときに発せられなければなりません。

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

与えられたindex を持つデータ項目の編集に使用されるエディタを返します。インデックスには、使用されているモデルに関する情報が含まれていることに注意してください。エディタの親ウィジェットはparent で指定され、項目オプションはoption で指定されます。

基本実装はnullptr を返します。カスタム編集を行いたい場合は、この関数を再実装する必要があります。

返されたエディタウィジェットはQt::StrongFocus を持つ必要があります。そうでない場合、ウィジェットが受け取ったQMouseEventはビューに伝搬します。エディタが独自の背景を描画しない限り、ビューの背景が透けて見えます（例えば、setAutoFillBackground()）。

destroyEditor(),setModelData(),setEditorData()も参照してください 。

[virtual] void QAbstractItemDelegate::destroyEditor(QWidget *editor, const QModelIndex &index) const

指定されたindex を持つデータ項目の編集にeditor が不要になり、破棄されるべきときに呼び出されます。デフォルトの動作はエディタのdeleteLaterの呼び出しです。この関数を再実装することで、この削除を回避することができます。

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

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

アイテムの編集が開始されると、この関数は編集のトリガーとなったevent 、アイテムのmodel 、index 、アイテムのレンダリングに使用されたoption 。

アイテムの編集が開始されなくても、マウスイベントはeditorEvent()に送られます。これは例えば、アイテム上でマウスの右ボタンが押されたときにコンテキストメニューを開きたい場合に便利です。

基本実装はfalse を返します（イベントを処理していないことを示します）。

[virtual] bool QAbstractItemDelegate::helpEvent(QHelpEvent *event, QAbstractItemView *view, const QStyleOptionViewItem &option, const QModelIndex &index)

ヘルプイベントが発生するたびに、この関数はevent view option と、イベントが発生したアイテムに対応するindex で呼び出される。

デリゲートがイベントを処理できる場合はtrue を返し、そうでない場合はfalse を返す。trueの戻り値は、インデックスを使用して取得されたデータが必要な役割を持っていたことを示します。

QEvent::ToolTip とQEvent::WhatsThis イベントが正常に処理された場合、ユーザのシステム構成に応じて関連するポップアップが表示されるかもしれません。

QHelpEventも参照して ください。

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

カスタムレンダリングを行いたい場合は、この純粋抽象関数を再実装する必要があります。アイテムindex で指定されたアイテムをレンダリングするには、painter とスタイルoption を使用します。

これを再実装する場合は、sizeHint() も再実装する必要があります。

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

与えられたeditor の内容を、与えられたindex の項目のデータに設定する。インデックスには、使用されているモデルに関する情報が含まれていることに注意してください。

基本実装は何もしません。カスタム編集を行いたい場合は、この関数を再実装する必要があります。

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

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

model の指定されたindex の項目のデータを、指定されたeditor の内容に設定する。

基本実装は何もしません。カスタム編集を行いたい場合は、この関数を再実装する必要があります。

setEditorData()も参照 。

[pure virtual] QSize QAbstractItemDelegate::sizeHint(const QStyleOptionViewItem &option, const QModelIndex &index) const

カスタムレンダリングを提供したい場合は、この純粋な抽象関数を再実装する必要があります。オプションはoption で指定され、モデル項目はindex で指定されます。

これを再実装する場合は、paint() も再実装する必要があります。

[signal] void QAbstractItemDelegate::sizeHintChanged(const QModelIndex &index)

このシグナルは、index のsizeHint() が変更されたときに発せられなければならない。

ビューは自動的にこのシグナルに接続し、必要に応じてアイテムをリレー出力します。

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

指定されたindex を持つアイテムのeditor のジオメトリを、option で指定された長方形に従って更新する。 アイテムが内部レイアウトを持っている場合、エディタはそれに従ってレイアウトされる。インデックスには、使用されているモデルに関する情報が含まれていることに注意してください。

基本実装は何もしません。カスタム編集を行いたい場合は、この関数を再実装する必要があります。