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

지정된 ` index`에 대해, ` painter ` 및 ` option` 스타일을 사용하여 항목 배경을 렌더링합니다.

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

rect 로 지정된 사각형 내에, 주어진 painter 와 스타일 option 을 사용하여, 주어진 state 를 적용하여 체크 표시기를 렌더링합니다.

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

지정된 rect 내의 직사각형 영역에, 주어진 painter 및 스타일 option 을 사용하여 pixmap 장식을 렌더링합니다.

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

rect 로 지정된 사각형 영역 내에서, 주어진 painter 및 스타일 option 을 사용하여 항목 뷰 text 를 렌더링합니다.

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

rect 로 지정된 사각형 내의 영역을, 주어진 painter 및 스타일 option 을 사용하여 렌더링하며, 해당 영역에 포커스가 있음을 나타냅니다.

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

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

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

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 을 사용하여 델리게이트를 렌더링합니다.

서브클래스에서 이 함수를 재구현할 때는, 옵션의 rect 변수가 차지하는 영역을 업데이트하고, 옵션의 state 변수를 사용하여 표시할 항목의 상태를 판단한 다음, 그에 따라 렌더링 방식을 조정해야 합니다.

예를 들어, 다음 코드에서 볼 수 있듯이 선택된 항목은 선택되지 않은 항목과 다르게 표시되어야 할 수 있습니다.

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

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

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

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

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

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