QAbstractItemView Class

멤버 함수 문서

[explicit] QAbstractItemView::QAbstractItemView(QWidget *parent = nullptr)

주어진 parent 으로 추상적인 항목 보기를 구성합니다.

[virtual noexcept] QAbstractItemView::~QAbstractItemView()

보기를 파괴합니다.

[signal] void QAbstractItemView::activated(const QModelIndex &index)

이 신호는 index 에서 지정한 항목을 사용자가 활성화할 때 발생합니다. 항목을 활성화하는 방법은 플랫폼에 따라 다릅니다(예: 항목을 한 번 또는 두 번 클릭하거나 항목이 현재 상태일 때 Return 또는 Enter 키를 누르는 방법).

clicked(), doubleClicked(), entered() 및 pressed()도 참조하세요 .

[slot] void QAbstractItemView::clearSelection()

선택한 모든 항목을 선택 취소합니다. 현재 인덱스는 변경되지 않습니다.

setSelection() 및 selectAll()도 참조하세요 .

[signal] void QAbstractItemView::clicked(const QModelIndex &index)

이 신호는 마우스 버튼을 마우스 왼쪽 버튼으로 클릭할 때 발생합니다. 마우스가 클릭한 항목은 index 으로 지정됩니다. 이 신호는 인덱스가 유효한 경우에만 발생합니다.

activated(), doubleClicked(), entered() 및 pressed()도 참조하세요 .

[virtual protected slot] void QAbstractItemView::closeEditor(QWidget *editor, QAbstractItemDelegate::EndEditHint hint)

지정된 editor 을 닫고 릴리스합니다. hint 은 편집 작업이 끝날 때 뷰가 어떻게 응답해야 하는지 지정하는 데 사용됩니다. 예를 들어 뷰의 다음 항목을 편집을 위해 열어야 한다는 힌트가 표시될 수 있습니다.

edit() 및 commitData()도 참조하십시오 .

void QAbstractItemView::closePersistentEditor(const QModelIndex &index)

지정된 index 에서 항목의 영구 편집기를 닫습니다.

openPersistentEditor() 및 isPersistentEditorOpen()도 참조하세요 .

[virtual protected slot] void QAbstractItemView::commitData(QWidget *editor)

editor 에 있는 데이터를 모델에 커밋합니다.

closeEditor()도 참조하세요 .

[virtual protected slot] void QAbstractItemView::currentChanged(const QModelIndex &current, const QModelIndex &previous)

이 슬롯은 새 항목이 현재 항목이 될 때 호출됩니다. 이전 현재 항목은 previous 인덱스로, 새 항목은 current 인덱스로 지정됩니다.

항목의 변경 사항을 알고 싶으면 dataChanged() 신호를 참조하세요.

QModelIndex QAbstractItemView::currentIndex() const

현재 항목의 모델 인덱스를 반환합니다.

setCurrentIndex()도 참조하세요 .

[virtual protected slot] void QAbstractItemView::dataChanged(const QModelIndex &topLeft, const QModelIndex &bottomRight, const QList<int> &roles = QList<int>())

이 슬롯은 모델에서 roles 이 지정된 항목이 변경될 때 호출됩니다. 변경된 항목은 topLeft 에서 bottomRight 로 변경된 항목입니다. 하나의 항목만 변경된 경우 topLeft == bottomRight.

변경된 roles 은 빈 컨테이너(모든 항목이 변경되었음을 의미)이거나 변경된 역할의 하위 집합이 있는 비어 있지 않은 컨테이너일 수 있습니다.

[protected] QPoint QAbstractItemView::dirtyRegionOffset() const

뷰에서 더티 영역의 오프셋을 반환합니다.

scrollDirtyRegion()를 사용하고 QAbstractItemView 의 하위 클래스에서 paintEvent()를 구현하는 경우 이 함수에서 반환된 오프셋을 사용하여 페인트 이벤트에 지정된 영역을 변환해야 합니다.

scrollDirtyRegion() 및 setDirtyRegion()도 참조하십시오 .

[signal] void QAbstractItemView::doubleClicked(const QModelIndex &index)

이 신호는 마우스 버튼을 더블클릭할 때 발생합니다. 마우스가 더블 클릭한 항목은 index 으로 지정됩니다. 이 신호는 인덱스가 유효한 경우에만 발생합니다.

clicked() 및 activated()도 참조하세요 .

[override virtual protected] void QAbstractItemView::dragEnterEvent(QDragEnterEvent *event)

다시 구현합니다: QAbstractScrollArea::dragEnterEvent(QDragEnterEvent * 이벤트).

이 함수는 드래그 앤 드롭 작업이 위젯에 들어갈 때 주어진 event 과 함께 호출됩니다. 드래그가 유효한 드롭 위치(예: 드롭을 허용하는 항목 위)에 있으면 이벤트가 수락되고, 그렇지 않으면 무시됩니다.

dropEvent() 및 startDrag()도 참조하세요 .

[override virtual protected] void QAbstractItemView::dragLeaveEvent(QDragLeaveEvent *event)

다시 구현합니다: QAbstractScrollArea::dragLeaveEvent(QDragLeaveEvent * 이벤트).

이 함수는 드래그 중인 항목이 뷰를 떠날 때 호출됩니다. event 은 드래그 앤 드롭 작업의 상태를 설명합니다.

[override virtual protected] void QAbstractItemView::dragMoveEvent(QDragMoveEvent *event)

다시 구현합니다: QAbstractScrollArea::dragMoveEvent(QDragMoveEvent * 이벤트).

이 함수는 위젯을 드래그 앤 드롭하는 동안 지정된 event 와 함께 연속적으로 호출됩니다. 예를 들어 사용자가 선택 항목을 뷰의 오른쪽 또는 아래쪽 가장자리로 드래그하면 뷰가 스크롤될 수 있습니다. 이 경우 이벤트가 허용되지만 그렇지 않으면 무시됩니다.

dropEvent() 및 startDrag()도 참조하세요 .

[override virtual protected] void QAbstractItemView::dropEvent(QDropEvent *event)

다시 구현합니다: QAbstractScrollArea::dropEvent(QDropEvent * 이벤트).

이 함수는 위젯에서 드롭 이벤트가 발생하면 주어진 event 과 함께 호출됩니다. 모델이 짝수 위치를 수락하면 드롭 이벤트가 수락되고, 그렇지 않으면 무시됩니다.

startDrag()도 참조하세요 .

[protected] QAbstractItemView::DropIndicatorPosition QAbstractItemView::dropIndicatorPosition() const

가장 가까운 항목을 기준으로 드롭 표시기의 위치를 반환합니다.

[slot] void QAbstractItemView::edit(const QModelIndex &index)

주어진 index 에 해당하는 항목이 수정 가능한 경우 수정을 시작합니다.

이 함수는 현재 색인을 변경하지 않습니다. 현재 색인은 편집할 다음 항목과 이전 항목을 정의하므로 사용자가 키보드 탐색이 예상대로 작동하지 않을 수 있습니다. 일관된 탐색 동작을 제공하려면 이 함수 앞에 동일한 모델 인덱스를 사용하여 setCurrentIndex()를 호출하세요.

QModelIndex::flags()도 참조하세요 .

[virtual protected] bool QAbstractItemView::edit(const QModelIndex &index, QAbstractItemView::EditTrigger trigger, QEvent *event)

index 에서 항목 편집을 시작하고 필요한 경우 편집기를 만든 다음 뷰의 State 가 현재 EditingState 인 경우 true 을 반환하고 그렇지 않으면 false 을 반환합니다.

편집 프로세스를 유발한 작업은 trigger 으로 설명되고 관련 이벤트는 event 으로 지정됩니다.

trigger 을 QAbstractItemView::AllEditTriggers 으로 지정하여 편집을 강제할 수 있습니다.

closeEditor()도 참조하십시오 .

[virtual protected slot] void QAbstractItemView::editorDestroyed(QObject *editor)

이 함수는 주어진 editor 이 파괴되었을 때 호출됩니다.

closeEditor()도 참조하세요 .

[signal] void QAbstractItemView::entered(const QModelIndex &index)

이 신호는 마우스 커서가 index 에 지정된 항목에 들어갈 때 방출됩니다. 이 기능을 사용하려면 마우스 추적을 활성화해야 합니다.

viewportEntered(), activated(), clicked(), doubleClicked() 및 pressed()도 참조하세요 .

[override virtual protected] bool QAbstractItemView::event(QEvent *event)

다시 구현합니다: QAbstractScrollArea::event(QEvent * 이벤트).

[override virtual protected] bool QAbstractItemView::eventFilter(QObject *object, QEvent *event)

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

[protected] void QAbstractItemView::executeDelayedItemsLayout()

이벤트 처리가 시작될 때까지 기다리지 않고 예약된 레이아웃을 실행합니다.

scheduleDelayedItemsLayout()도 참조하세요 .

[override virtual protected] void QAbstractItemView::focusInEvent(QFocusEvent *event)

다시 구현합니다: QWidget::focusInEvent(QFocusEvent * 이벤트).

이 함수는 위젯이 포커스를 획득할 때 주어진 event 과 함께 호출됩니다. 기본적으로 이벤트는 무시됩니다.

setFocus() 및 focusOutEvent()도 참조하세요 .

[override virtual protected] bool QAbstractItemView::focusNextPrevChild(bool next)

다시 구현합니다: QWidget::focusNextPrevChild(다음 부울).

[override virtual protected] void QAbstractItemView::focusOutEvent(QFocusEvent *event)

다시 구현합니다: QWidget::focusOutEvent(QFocusEvent * 이벤트).

이 함수는 위젯이 포커스를 잃을 때 주어진 event 과 함께 호출됩니다. 기본적으로 이벤트는 무시됩니다.

clearFocus() 및 focusInEvent()도 참조하세요 .

[pure virtual protected] int QAbstractItemView::horizontalOffset() const

뷰의 가로 오프셋을 반환합니다.

베이스 클래스에서 이것은 순수한 가상 함수입니다.

verticalOffset()도 참조하십시오 .

[pure virtual] QModelIndex QAbstractItemView::indexAt(const QPoint &point) const

뷰포트 좌표에서 항목의 모델 인덱스를 반환합니다 point.

베이스 클래스에서 이것은 순수 가상 함수입니다.

visualRect()도 참조하십시오 .

QWidget *QAbstractItemView::indexWidget(const QModelIndex &index) const

지정된 index 에 있는 항목의 위젯을 반환합니다.

setIndexWidget()도 참조하세요 .

[virtual protected, since 6.0] void QAbstractItemView::initViewItemOption(QStyleOptionViewItem *option) const

뷰의 팔레트, 글꼴, 상태, 정렬 등을 사용하여 option 구조를 초기화합니다.

이 함수는 Qt 6.0에 도입되었습니다.

[override virtual protected] void QAbstractItemView::inputMethodEvent(QInputMethodEvent *event)

다시 구현합니다: QWidget::inputMethodEvent(Q입력메소드이벤트 *이벤트).

[override virtual] QVariant QAbstractItemView::inputMethodQuery(Qt::InputMethodQuery query) const

재구현합니다: QWidget::inputMethodQuery(Qt::InputMethodQuery 쿼리) const.

[pure virtual protected] bool QAbstractItemView::isIndexHidden(const QModelIndex &index) const

지정된 index 에서 참조하는 항목이 뷰에서 숨겨져 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

숨기기는 뷰별 기능입니다. 예를 들어 TableView 에서 열을 숨김으로 표시하거나 TreeView 에서 행을 숨김으로 표시할 수 있습니다.

베이스 클래스에서 이 함수는 순수 가상 함수입니다.

bool QAbstractItemView::isPersistentEditorOpen(const QModelIndex &index) const

인덱스 index 에서 항목에 대한 영구 편집기가 열려 있는지 여부를 반환합니다.

openPersistentEditor() 및 closePersistentEditor()도 참조하세요 .

QAbstractItemDelegate *QAbstractItemView::itemDelegate() const

이 뷰 및 모델에서 사용하는 항목 델리게이트를 반환합니다. setItemDelegate ()로 설정되거나 기본값입니다.

setItemDelegate()도 참조하세요 .

QAbstractItemDelegate *QAbstractItemView::itemDelegateForColumn(int column) const

주어진 column 에 대해 이 뷰 및 모델에서 사용하는 항목 델리게이트를 반환합니다. itemDelegate ()를 호출하여 주어진 인덱스에 대한 현재 대리자에 대한 포인터를 가져올 수 있습니다.

setItemDelegateForColumn(), itemDelegateForRow() 및 itemDelegate()도 참조하세요 .

[virtual, since 6.0] QAbstractItemDelegate *QAbstractItemView::itemDelegateForIndex(const QModelIndex &index) const

주어진 index 에 대해 이 뷰와 모델에서 사용하는 항목 델리게이트를 반환합니다.

이 함수는 Qt 6.0에 도입되었습니다.

setItemDelegate(), setItemDelegateForRow() 및 setItemDelegateForColumn()도 참조하십시오 .

QAbstractItemDelegate *QAbstractItemView::itemDelegateForRow(int row) const

지정된 row, 또는 델리게이트가 할당되지 않은 경우 nullptr 에 대해 이 뷰 및 모델에서 사용하는 항목 델리게이트를 반환합니다. itemDelegate ()를 호출하여 주어진 인덱스에 대한 현재 대리자에 대한 포인터를 가져올 수 있습니다.

setItemDelegateForRow(), itemDelegateForColumn() 및 setItemDelegate()도 참조하세요 .

[override virtual protected] void QAbstractItemView::keyPressEvent(QKeyEvent *event)

다시 구현합니다: QAbstractScrollArea::keyPressEvent(QKeyEvent *e).

이 함수는 키 이벤트가 위젯으로 전송될 때 지정된 event 와 함께 호출됩니다. 기본 구현은 위, 아래, 왼쪽, 오른쪽, 홈, 페이지업, 페이지다운과 같은 기본적인 커서 이동을 처리하며, 현재 인덱스가 유효하고 활성화 키(예: 플랫폼에 따라 Enter 또는 Return)를 누르면 activated() 신호가 전송됩니다. 이 기능은 F2를 누르는 등 키를 눌러 편집이 시작되는 곳입니다.

edit(), moveCursor(), keyboardSearch() 및 tabKeyNavigation 을참조하세요 .

[virtual] void QAbstractItemView::keyboardSearch(const QString &search)

문자열 search 과 가장 일치하는 항목으로 이동하여 선택합니다. 항목을 찾지 못하면 아무 일도 일어나지 않습니다.

기본 구현에서는 search 이 비어 있거나 마지막 검색 이후 시간 간격이 QApplication::keyboardInputInterval()을 초과한 경우 검색이 재설정됩니다.

QAbstractItemModel *QAbstractItemView::model() const

이 뷰가 표시하는 모델을 반환합니다.

setModel()도 참조하십시오 .

[override virtual protected] void QAbstractItemView::mouseDoubleClickEvent(QMouseEvent *event)

다시 구현합니다: QAbstractScrollArea::mouseDoubleClickEvent(QMouseEvent *e).

이 함수는 위젯 내에서 마우스 버튼을 두 번 클릭하면 주어진 event 과 함께 호출됩니다. 더블 클릭이 유효한 항목에 있으면 doubleClicked() 신호를 보내고 해당 항목에서 edit()를 호출합니다.

[override virtual protected] void QAbstractItemView::mouseMoveEvent(QMouseEvent *event)

다시 구현합니다: QAbstractScrollArea::mouseMoveEvent(QMouseEvent *e).

이 함수는 마우스 이동 이벤트가 위젯으로 전송될 때 주어진 event 과 함께 호출됩니다. 선택이 진행 중이고 새 항목이 선택 영역 위로 이동하면 선택 영역이 확장되고, 드래그가 진행 중이면 드래그가 계속됩니다.

[override virtual protected] void QAbstractItemView::mousePressEvent(QMouseEvent *event)

다시 구현합니다: QAbstractScrollArea::mousePressEvent(QMouseEvent *e).

이 함수는 커서가 위젯 안에 있는 동안 마우스 버튼을 누르면 주어진 event 과 함께 호출됩니다. 유효한 항목을 누르면 현재 항목이 만들어집니다. 이 함수는 pressed() 신호를 방출합니다.

[override virtual protected] void QAbstractItemView::mouseReleaseEvent(QMouseEvent *event)

다시 구현합니다: QAbstractScrollArea::mouseReleaseEvent(QMouseEvent *e).

이 함수는 위젯에서 마우스 누르기 이벤트가 발생한 후 마우스 버튼이 해제될 때 주어진 event 과 함께 호출됩니다. 사용자가 위젯 안에서 마우스를 누른 다음 마우스 버튼을 놓기 전에 마우스를 다른 위치로 드래그하면 위젯이 릴리스 이벤트를 수신합니다. 이 함수는 항목을 누르고 있는 경우 clicked() 신호를 전송합니다.

[pure virtual protected] QModelIndex QAbstractItemView::moveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers)

주어진 cursorAction 및 modifiers 에 지정된 키보드 수정자를 기반으로 뷰의 다음 개체를 가리키는 QModelIndex 개체를 반환합니다.

베이스 클래스에서 이것은 순수한 가상 함수입니다.

void QAbstractItemView::openPersistentEditor(const QModelIndex &index)

지정된 index 에서 항목에 대한 영구 편집기를 엽니다. 편집기가 존재하지 않으면 대리인이 새 편집기를 만듭니다.

closePersistentEditor() 및 isPersistentEditorOpen()도 참조하세요 .

[signal] void QAbstractItemView::pressed(const QModelIndex &index)

이 신호는 마우스 버튼을 눌렀을 때 방출됩니다. 마우스가 눌린 항목은 index 으로 지정됩니다. 이 신호는 인덱스가 유효한 경우에만 방출됩니다.

마우스 버튼의 상태를 가져오려면 QGuiApplication::mouseButtons() 함수를 사용합니다.

activated(), clicked(), doubleClicked() 및 entered()도 참조하세요 .

[virtual slot] void QAbstractItemView::reset()

뷰의 내부 상태를 재설정합니다.

[override virtual protected] void QAbstractItemView::resizeEvent(QResizeEvent *event)

다시 구현합니다: QAbstractScrollArea::resizeEvent(QResizeEvent * 이벤트).

이 함수는 크기 조정 이벤트가 위젯으로 전송될 때 지정된 event 와 함께 호출됩니다.

QWidget::resizeEvent()도 참조하세요 .

QModelIndex QAbstractItemView::rootIndex() const

모델의 루트 항목의 모델 인덱스를 반환합니다. 루트 항목은 뷰의 최상위 항목에 대한 상위 항목입니다. 루트가 유효하지 않을 수 있습니다.

setRootIndex()도 참조하십시오 .

[virtual protected slot] void QAbstractItemView::rowsAboutToBeRemoved(const QModelIndex &parent, int start, int end)

이 슬롯은 행을 제거하려고 할 때 호출됩니다. 삭제되는 행은 start 에서 end 까지 지정된 parent 아래의 행입니다.

rowsInserted()도 참조하세요 .

[virtual protected slot] void QAbstractItemView::rowsInserted(const QModelIndex &parent, int start, int end)

이 슬롯은 행이 삽입될 때 호출됩니다. 새 행은 start 에서 end 까지의 지정된 parent 아래에 있는 행입니다. 기본 클래스 구현은 모델에서 fetchMore()를 호출하여 더 많은 데이터를 확인합니다.

rowsAboutToBeRemoved()도 참조하세요 .

[protected] void QAbstractItemView::scheduleDelayedItemsLayout()

이벤트 처리가 시작될 때 실행될 뷰의 항목 레이아웃을 예약합니다.

이벤트가 처리되기 전에 scheduleDelayedItemsLayout()이 여러 번 호출되더라도 뷰는 레이아웃을 한 번만 수행합니다.

executeDelayedItemsLayout()도 참조하세요 .

[protected] void QAbstractItemView::scrollDirtyRegion(int dx, int dy)

더티 영역을 반대 방향으로 이동하여 뷰를 (dx,dy) 픽셀 단위로 스크롤할 수 있도록 준비합니다. 뷰 서브클래스에서 스크롤 뷰포트를 구현하는 경우에만 이 함수를 호출하면 됩니다.

QAbstractItemView 의 하위 클래스에서 scrollContentsBy() 를 구현하는 경우 뷰포트에서 QWidget::scroll() 를 호출하기 전에 이 함수를 호출하세요. 또는 update()를 호출하세요.

scrollContentsBy(), dirtyRegionOffset() 및 setDirtyRegion()도 참조하세요 .

[pure virtual] void QAbstractItemView::scrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint = EnsureVisible)

필요한 경우 뷰를 스크롤하여 index 에 있는 항목이 표시되도록 합니다. 뷰는 주어진 hint 에 따라 항목의 위치를 지정하려고 시도합니다.

베이스 클래스에서 이것은 순수한 가상 함수입니다.

[slot] void QAbstractItemView::scrollToBottom()

보기를 아래로 스크롤합니다.

scrollTo() 및 scrollToTop()도 참조하세요 .

[slot] void QAbstractItemView::scrollToTop()

보기를 맨 위로 스크롤합니다.

scrollTo() 및 scrollToBottom()도 참조하세요 .

[virtual slot] void QAbstractItemView::selectAll()

뷰의 모든 항목을 선택합니다. 이 함수는 선택할 때 뷰에 설정된 선택 동작을 사용합니다.

setSelection(), selectedIndexes() 및 clearSelection()도 참조하십시오 .

[virtual protected] QModelIndexList QAbstractItemView::selectedIndexes() const

이 편의 함수는 뷰에서 선택된 모든 항목 및 숨겨지지 않은 항목 인덱스의 목록을 반환합니다. 이 목록에는 중복 항목이 포함되지 않으며 정렬되지 않습니다.

QItemSelectionModel::selectedIndexes()도 참조하세요 .

[virtual protected slot] void QAbstractItemView::selectionChanged(const QItemSelection &selected, const QItemSelection &deselected)

이 슬롯은 선택 영역이 변경될 때 호출됩니다. 이전 선택 항목(비어 있을 수 있음)은 deselected 으로 지정하고 새 선택 항목은 selected 으로 지정합니다.

setSelection()도 참조하세요 .

[virtual protected] QItemSelectionModel::SelectionFlags QAbstractItemView::selectionCommand(const QModelIndex &index, const QEvent *event = nullptr) const

지정된 index 에 대한 선택 모델을 업데이트할 때 사용할 SelectionFlags를 반환합니다. 결과는 현재 selectionMode() 및 사용자 입력 이벤트 event( nullptr 일 수 있음)에 따라 달라집니다.

이 함수를 다시 구현하여 고유한 선택 동작을 정의하세요.

setSelection()도 참조하세요 .

QItemSelectionModel *QAbstractItemView::selectionModel() const

현재 선택 모델을 반환합니다.

setSelectionModel() 및 selectedIndexes()도 참조하세요 .

[slot] void QAbstractItemView::setCurrentIndex(const QModelIndex &index)

현재 항목을 index 의 항목으로 설정합니다.

현재 선택 모드가 NoSelection 이 아닌 경우 항목도 선택됩니다. 이 함수는 사용자가 수행하는 모든 새 선택의 시작 위치도 업데이트합니다.

항목을 선택하지 않고 현재 항목으로 설정하려면 다음을 호출합니다.

selectionModel()->setCurrentIndex(index, QItemSelectionModel::NoUpdate);

currentIndex(), currentChanged() 및 selectionMode 를참조하세요 .

[protected] void QAbstractItemView::setDirtyRegion(const QRegion &region)

주어진 region 을 더티로 표시하고 업데이트하도록 예약합니다. 자체 뷰 서브클래스를 구현하는 경우에만 이 함수를 호출하면 됩니다.

scrollDirtyRegion() 및 dirtyRegionOffset()도 참조하세요 .

void QAbstractItemView::setIndexWidget(const QModelIndex &index, QWidget *widget)

주어진 index 에 있는 항목에 주어진 widget 을 설정하여 위젯의 소유권을 뷰포트에 전달합니다.

index 가 유효하지 않은 경우(예: 루트 인덱스를 전달한 경우) 이 함수는 아무 작업도 수행하지 않습니다.

지정된 widget 의 autoFillBackground 속성을 true로 설정해야 하며, 그렇지 않으면 위젯의 배경이 투명하게 표시되어 모델 데이터와 지정된 index 에 있는 항목이 모두 표시됩니다.

setIndexWidget(index, new QLineEdit);
...
setIndexWidget(index, new QTextEdit);

이 함수는 데이터 항목에 해당하는 표시 영역 내에 정적 콘텐츠를 표시할 때만 사용해야 합니다. 사용자 정의 동적 콘텐츠를 표시하거나 사용자 정의 편집기 위젯을 구현하려면 QStyledItemDelegate 서브클래스를 대신 사용하세요.

indexWidget() 및 델리게이트 클래스도참조하세요 .

void QAbstractItemView::setItemDelegate(QAbstractItemDelegate *delegate)

이 보기 및 해당 모델의 항목 위임자를 delegate 으로 설정합니다. 항목의 편집 및 표시를 완벽하게 제어하려는 경우에 유용합니다.

기존 위임자는 제거되지만 삭제되지는 않습니다. QAbstractItemView 은 delegate 에 대한 소유권을 갖지 않습니다.

itemDelegate()도 참조하세요 .

void QAbstractItemView::setItemDelegateForColumn(int column, QAbstractItemDelegate *delegate)

주어진 column 에 대해 이 뷰 및 모델에서 사용하는 지정된 항목 delegate 을 설정합니다. column 의 모든 항목은 기본 대리자(즉, itemDelegate())를 사용하는 대신 delegate 에 의해 그려지고 관리됩니다.

column 에 대한 기존 열 델리게이트는 제거되지만 삭제되지는 않습니다. QAbstractItemView 은 delegate 에 대한 소유권을 갖지 않습니다.

itemDelegateForColumn(), setItemDelegateForRow() 및 itemDelegate()도 참조하세요 .

void QAbstractItemView::setItemDelegateForRow(int row, QAbstractItemDelegate *delegate)

주어진 row 에 대해 이 뷰 및 모델에서 사용하는 지정된 항목 delegate 을 설정합니다. row 의 모든 항목은 기본 대리자(즉, itemDelegate())를 사용하는 대신 delegate 에 의해 그려지고 관리됩니다.

row 에 대한 기존 행 위임자는 제거되지만 삭제되지는 않습니다. QAbstractItemView 은 delegate 에 대한 소유권을 갖지 않습니다.

itemDelegateForRow(), setItemDelegateForColumn() 및 itemDelegate()도 참조하세요 .

[virtual] void QAbstractItemView::setModel(QAbstractItemModel *model)

뷰에 표시할 model 을 설정합니다.

이 함수는 이전에 setSelectionModel()로 설정된 모든 모델을 대체하여 새 선택 모델을 만들고 설정합니다. 그러나 이전 선택 모델은 여러 뷰 간에 공유될 수 있으므로 삭제되지 않습니다. 더 이상 필요하지 않은 경우 이전 선택 모델을 삭제하는 것이 좋습니다. 이 작업은 다음 코드를 사용하여 수행합니다:

QItemSelectionModel *m = view->selectionModel();
view->setModel(new model);
delete m;

이전 모델과 이전 선택 모델에 모두 부모가 없거나 부모가 수명이 긴 개체인 경우 deleteLater() 함수를 호출하여 명시적으로 삭제하는 것이 좋습니다.

뷰는 모델이 여러 다른 뷰 간에 공유될 수 있으므로 모델의 부모 개체가 아닌 한 모델의 소유권을 갖지 않습니다.

model(), selectionModel() 및 setSelectionModel()도 참조하세요 .

[virtual slot] void QAbstractItemView::setRootIndex(const QModelIndex &index)

루트 항목을 지정된 index 에 있는 항목으로 설정합니다.

rootIndex()도 참조하세요 .

[pure virtual protected] void QAbstractItemView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags flags)

사각형 안에 있거나 사각형이 터치한 항목에 flags 선택을 적용합니다( rect).

자체 아이템뷰를 구현할 때는 selectionModel()->select(선택, 플래그)를 호출해야 하며, 여기서 선택은 빈 QModelIndex 또는 rect 에 포함된 모든 항목을 포함하는 QItemSelection 입니다.

selectionCommand() 및 selectedIndexes()도 참조하세요 .

[virtual] void QAbstractItemView::setSelectionModel(QItemSelectionModel *selectionModel)

현재 선택 모델을 지정된 selectionModel 으로 설정합니다.

이 함수 뒤에 setModel()를 호출하면 지정된 selectionModel 이 뷰에서 만든 것으로 대체됩니다.

selectionModel(), setModel() 및 clearSelection()도 참조하세요 .

[protected] void QAbstractItemView::setState(QAbstractItemView::State state)

항목 보기의 상태를 지정된 state 으로 설정합니다.

state()도 참조하세요 .

[virtual] int QAbstractItemView::sizeHintForColumn(int column) const

지정된 column 또는 모델이 없는 경우 -1에 대한 너비 크기 힌트를 반환합니다.

이 함수는 가로 머리글이 있는 뷰에서 지정된 column 의 내용을 기반으로 머리글 섹션의 크기 힌트를 찾는 데 사용됩니다.

sizeHintForRow()도 참조하십시오 .

QSize QAbstractItemView::sizeHintForIndex(const QModelIndex &index) const

지정된 index 또는 잘못된 인덱스의 경우 잘못된 크기의 항목에 대한 크기 힌트를 반환합니다.

sizeHintForRow() 및 sizeHintForColumn()도 참조하세요 .

[virtual] int QAbstractItemView::sizeHintForRow(int row) const

지정된 row 또는 모델이 없는 경우 -1에 대한 높이 크기 힌트를 반환합니다.

반환된 높이는 지정된 row 항목의 크기 힌트를 사용하여 계산됩니다. 즉, 반환된 값은 항목 중 최대 높이입니다. 행의 높이를 제어하려면 QAbstractItemDelegate::sizeHint() 함수를 다시 구현해야 합니다.

이 함수는 세로 머리글이 있는 뷰에서 주어진 row 의 내용을 기반으로 머리글 섹션의 크기 힌트를 찾는 데 사용됩니다.

sizeHintForColumn()도 참조하세요 .

[virtual protected] void QAbstractItemView::startDrag(Qt::DropActions supportedActions)

주어진 supportedActions 을 사용하여 drag->exec()을 호출하여 드래그를 시작합니다.

[protected] QAbstractItemView::State QAbstractItemView::state() const

항목 보기의 상태를 반환합니다.

setState()도 참조하세요 .

[override virtual protected] void QAbstractItemView::timerEvent(QTimerEvent *event)

다시 구현합니다: QObject::timerEvent(QTimerEvent * 이벤트).

이 함수는 타이머 이벤트가 위젯으로 전송될 때 주어진 event 와 함께 호출됩니다.

QObject::timerEvent()도 참조하세요 .

[slot] void QAbstractItemView::update(const QModelIndex &index)

주어진 index 이 차지하는 영역을 업데이트합니다.

[virtual protected slot] void QAbstractItemView::updateGeometries()

뷰의 자식 위젯의 지오메트리를 업데이트합니다.

[pure virtual protected] int QAbstractItemView::verticalOffset() const

뷰의 세로 오프셋을 반환합니다.

베이스 클래스에서 이것은 순수한 가상 함수입니다.

horizontalOffset()도 참조하십시오 .

[signal] void QAbstractItemView::viewportEntered()

이 신호는 마우스 커서가 뷰포트에 들어올 때 방출됩니다. 이 기능이 작동하려면 마우스 추적을 활성화해야 합니다.

entered()도 참조하세요 .

[override virtual protected] bool QAbstractItemView::viewportEvent(QEvent *event)

다시 구현합니다: QAbstractScrollArea::viewportEvent(QEvent * 이벤트).

이 함수는 주어진 event 이 QEvent::ToolTip 이거나 QEvent::WhatsThis 인 경우 도구 팁과 What's This? 모드를 처리하는 데 사용됩니다. 다른 모든 이벤트는 기본 클래스 viewportEvent() 핸들러로 전달합니다.

event 이 인식되어 처리된 경우 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

[override virtual protected] QSize QAbstractItemView::viewportSizeHint() const

재구현합니다: QAbstractScrollArea::viewportSizeHint() const.

[pure virtual] QRect QAbstractItemView::visualRect(const QModelIndex &index) const

index 에서 항목이 차지하는 뷰포트의 사각형을 반환합니다.

항목이 여러 영역에 표시되는 경우 visualRect는 인덱스가 포함하거나 터치하거나 그리기를 유발할 수 있는 전체 영역이 아닌 인덱스가 포함된 기본 영역을 반환해야 합니다.

베이스 클래스에서 이것은 순수한 가상 함수입니다.

indexAt() 및 visualRegionForSelection()도 참조하세요 .

[pure virtual protected] QRegion QAbstractItemView::visualRegionForSelection(const QItemSelection &selection) const

주어진 selection 에 있는 항목의 뷰포트에서 영역을 반환합니다.

베이스 클래스에서 이것은 순수한 가상 함수입니다.

visualRect() 및 selectedIndexes()도 참조하세요 .