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

이 함수는 locale 에서 모델의 Qt::DisplayRole 를 표시하는 데 델리게이트가 사용할 문자열을 반환합니다. value 는 모델이 제공하는 Qt::DisplayRole 의 값입니다.

기본 구현은 ` QLocale::toString `를 사용하여 ` value `을 ` QString`로 변환합니다.

이 함수는 빈 모델 인덱스, 즉 모델이 유효하지 않은 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 *object, QEvent *event)

QObject::eventFilter(QObject *watched, QEvent *event)를 재구현합니다.

자세한 내용은 QAbstractItemDelegate::handleEditorEvent()을 참조하십시오.

[virtual protected] void QStyledItemDelegate::initStyleOption(QStyleOptionViewItem *option, const QModelIndex &index) const

option index 를 인덱스를 사용하여 값으로 초기화합니다. 이 메서드는 하위 클래스에서 가 필요하지만, 모든 정보를 직접 입력하고 싶지 않을 때 유용합니다. 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를 재구현할 때는 initStyleOption()를 사용하여 QStyledItemDelegate 와 동일한 방식으로 option 를 설정하십시오.

가능한 한 페인팅 시 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를 재구현합니다.

model index 로 지정된 데이터 모델 항목에서 editor 가 표시하고 편집할 데이터를 설정합니다.

기본 구현은 데이터를 editor 위젯의 user 속성에 저장합니다.

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 위젯의 user 속성에서 데이터 모델에 저장될 값을 가져옵니다.

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를 재구현합니다.

index 로 지정된 항목에 대해, 주어진 스타일 option 에 따라 editor 를 업데이트합니다.