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

이 함수는 드래그 앤 드롭 작업이 위젯에 진입할 때 주어진 event 를 매개변수로 받아 호출됩니다. 드래그가 유효한 드롭 위치(예: 드롭을 허용하는 항목 위)를 지나갈 경우 이벤트가 수락되며, 그렇지 않은 경우 무시됩니다.

dropEvent() 및 startDrag()도 참조하십시오 .

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

QAbstractScrollArea::dragLeaveEvent(QDragLeaveEvent *event)를 재구현합니다.

이 함수는 드래그 중인 항목이 뷰를 벗어나면 호출됩니다. event 는 드래그 앤 드롭 작업의 상태를 나타냅니다.

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

QAbstractScrollArea::dragMoveEvent(QDragMoveEvent *event)를 재구현합니다.

이 함수는 위젯 위에서 드래그 앤 드롭 작업이 진행되는 동안 지정된 event 를 받아 지속적으로 호출됩니다. 예를 들어, 사용자가 선택한 영역을 뷰의 오른쪽 또는 하단 가장자리로 드래그하는 경우, 뷰가 스크롤될 수 있습니다. 이 경우 이벤트가 수락되며, 그렇지 않으면 무시됩니다.

dropEvent() 및 startDrag()도 참조하십시오 .

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

QAbstractScrollArea::dropEvent(QDropEvent *event)를 재구현합니다.

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

startDrag()도 참조하십시오 .

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

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

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

지정된 index 에 해당하는 항목이 편집 가능한 경우, 해당 항목의 편집을 시작합니다.

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

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        abstractItemView, qOverload(&QAbstractItemView::edit));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        abstractItemView, [receiver = abstractItemView](const QModelIndex &index) { receiver->edit(index); });

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

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

이 함수는 위젯이 포커스를 획득할 때 지정된 event 를 인수로 받아 호출됩니다. 기본적으로 이 이벤트는 무시됩니다.

setFocus() 및 focusOutEvent()도 참조하십시오 .

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

QWidget::focusNextPrevChild(bool next)를 재구현합니다.

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

QWidget::focusOutEvent(QFocusEvent *event)를 재구현합니다.

이 함수는 위젯이 포커스를 잃을 때 주어진 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(QInputMethodEvent *event)를 재구현합니다.

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

QWidget::inputMethodQuery(const Qt::InputMethodQuery query)를 재구현합니다.

[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 를 인수로 받아 호출됩니다. 기본 구현은 위, 아래, 왼쪽, 오른쪽, Home, PageUp 및 PageDown과 같은 기본적인 커서 이동을 처리합니다. 현재 인덱스가 유효하고 활성화 키(예: 플랫폼에 따라 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)를 재구현합니다.

위젯에 크기 조정 이벤트가 전송되면, 주어진 event 를 인수로 받아 이 함수가 호출됩니다.

QWidget::resizeEvent()도 참조하십시오 .

QModelIndex QAbstractItemView::rootIndex() const

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

setRootIndex()도 참조하십시오 .

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

이 슬롯은 행이 제거되기 직전에 호출됩니다. 삭제되는 행은 지정된 parent 에 해당하는, start 부터 end 까지(해당 값 포함)의 행들입니다.

rowsInserted()도 참조하십시오 .

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

이 슬롯은 행이 삽입될 때 호출됩니다. 새로운 행들은 주어진 parent 의 범위인 start 부터 end 까지(해당 주소 포함)에 해당하는 행들입니다. 기본 클래스의 구현은 모델의 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)

지정된 ` widget `를 지정된 ` index` 위치의 항목에 설정하고, 위젯의 소유권을 뷰포트에 넘겨줍니다.

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)

사각형( rect) 내에 있거나 사각형에 닿은 항목들에 선택( flags )을 적용합니다.

사용자 정의 itemview를 구현할 때, setSelection 메서드는 selectionModel()->select(selection, flags)를 호출해야 합니다. 여기서 selection은 빈 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)를 재구현합니다.

위젯에 타이머 이벤트가 전송되면, 주어진 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)를 재구현합니다.

이 함수는 주어진 event 가 QEvent::ToolTip 이거나 QEvent::WhatsThis 인 경우, 툴팁 및 "이게 뭐죠?" 모드를 처리하는 데 사용됩니다. 그 외의 모든 이벤트는 기본 클래스의 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는 index가 포함하거나 닿거나 그리기를 유발할 수 있는 전체 영역이 아닌, index를 포함하는 주 영역을 반환해야 합니다.

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

indexAt() 및 visualRegionForSelection()도 참조하십시오 .

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

지정된 ` selection`에 포함된 항목들의 뷰포트에서 해당 영역을 반환합니다.

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

visualRect() 및 selectedIndexes()도 참조하십시오 .