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

편집을 위해 index 에 지정된 항목을 편집하는 데 사용되는 위젯을 리턴합니다. parent 위젯과 option 스타일은 편집기 위젯이 표시되는 방식을 제어하는 데 사용됩니다.

QAbstractItemDelegate::createEditor()도 참조하세요 .

[protected] void QItemDelegate::drawBackground(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const

주어진 painter 및 스타일 option 을 사용하여 주어진 index 에 대한 항목 배경을 렌더링합니다.

[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

지정된 painter 및 스타일 option 을 사용하여 rect 에 지정된 사각형 내에 장식 pixmap 을 렌더링합니다.

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

지정된 painter 및 스타일 option 을 사용하여 rect 에 지정된 사각형 내에 항목 보기 text 를 렌더링합니다.

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

지정된 painter 및 스타일 option 을 사용하여 포커스가 있음을 나타내는 rect 으로 지정된 사각형 내의 영역을 렌더링합니다.

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

재구현합니다: QAbstractItemDelegate::editorEvent(QEvent * 이벤트, QAbstractItemModel * 모델, const Q스타일옵션뷰 아이템 &옵션, const Q모델 인덱스 &인덱스).

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

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

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

• Tab
• Backtab
• Enter
• Return
• Esc

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

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

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

QItemEditorFactory *QItemDelegate::itemEditorFactory() const

아이템 델리게이트가 사용하는 편집기 팩토리를 반환합니다. 편집기 팩토리가 설정되어 있지 않으면 이 함수는 null을 반환합니다.

setItemEditorFactory()도 참조하세요 .

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

재 구현합니다: QAbstractItemDelegate::paint(QPainter *페인터, 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.

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

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

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

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

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