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 と styleoption を使用します。

これを再実装する場合は、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 で指定された矩形に従って更新します。 アイテムに内部レイアウトがある場合、エディタはそれに従ってレイアウトされます。インデックスには、使用されているモデルに関する情報が含まれていることに注意してください。

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