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 *부모, const Q스타일옵션뷰아이템 &옵션, const Q모델인덱스 &인덱스) 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 * 이벤트, QAbstractItemModel * 모델, const Q스타일옵션뷰 아이템 &옵션, const Q모델 인덱스 &인덱스).

[override virtual protected] bool QStyledItemDelegate::eventFilter(QObject *editor, QEvent *event)

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

주어진 editor 이 유효한 QWidget 이고 주어진 event 이 처리되면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다. 기본적으로 다음과 같은 키 누르기 이벤트가 처리됩니다:

• Tab
• Backtab
• Enter
• Return
• Esc

editor 의 유형이 QTextEdit 또는 QPlainTextEdit 인 경우 Tab, Backtab, Enter 및 Return 키는 처리되지 않습니다.

Tab, Backtab, Enter 및 Return 키 누름 이벤트의 경우 editor 의 데이터가 모델에 커밋되고 편집기가 닫힙니다. event 가 Tab 키인 경우 뷰에서 뷰의 다음 항목에 대한 편집기가 열립니다. 마찬가지로 event 키가 Backtab 키인 경우 뷰의 이전 항목에 대한 편집기가 열립니다.

이벤트가 Esc 키 누름 이벤트인 경우 editor 은 데이터를 커밋하지 않고 닫힙니다.

commitData() 및 closeEditor()도 참조하세요 .

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

인덱스 index 를 사용하여 option 를 값으로 초기화합니다. 이 방법은 하위 클래스에 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 를 사용하여 항목을 칠합니다.

서브클래스에서 페인트를 다시 구현할 때 사용합니다. 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.

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

기본 구현은 editor 위젯의 사용자 프로퍼티에 데이터를 저장합니다.

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

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 *편집기, const QStyleOptionViewItem &option, const QModelIndex &index) const.

지정된 스타일 option 에 따라 index 에 지정된 항목의 editor 를 업데이트합니다.