QTreeView Class

QFileSystemModel *model = new QFileSystemModel;
model->setRootPath(QDir::currentPath());
QTreeView *tree = new QTreeView(splitter);
tree->setModel(model);

멤버 함수 설명서

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

모델의 데이터를 나타내기 위해 ` parent `을 사용하는 트리 뷰를 생성합니다. 모델을 설정하려면 ` setModel()`를 사용하십시오.

QAbstractItemModel도 참조하십시오 .

[virtual noexcept] QTreeView::~QTreeView()

트리 보기를 제거합니다.

[override virtual protected] void QTreeView::changeEvent(QEvent *event)

QFrame::changeEvent(QEvent *ev)를 재구현합니다.

[slot] void QTreeView::collapse(const QModelIndex &index)

index 로 지정된 모델 항목을 접습니다.

collapsed()도 참조하십시오 .

[slot] void QTreeView::collapseAll()

펼쳐진 항목을 모두 접습니다.

expandAll(), expand(), collapse() 및 setExpanded()도 참조하십시오 .

[signal] void QTreeView::collapsed(const QModelIndex &index)

index 로 지정된 항목이 접힐 때 이 신호가 발생합니다.

int QTreeView::columnAt(int x) const

주어진 x 좌표를 포함하는 헤더를 가진 트리 뷰의 열을 반환합니다.

[protected slot] void QTreeView::columnCountChanged(int oldCount, int newCount)

트리 뷰의 열 수가 oldCount 에서 newCount 로 변경되었음을 트리 뷰에 알립니다.

[protected slot] void QTreeView::columnMoved()

이 슬롯은 열이 이동될 때마다 호출됩니다.

[protected slot] void QTreeView::columnResized(int column, int oldSize, int newSize)

이 함수는 헤더에서 column 의 크기가 변경될 때마다 호출됩니다. oldSize 와 newSize 는 이전 크기와 새로운 크기를 픽셀 단위로 반환합니다.

setColumnWidth()도 참조하십시오 .

int QTreeView::columnViewportPosition(int column) const

뷰포트 내의 ` column `의 수평 위치를 반환합니다.

int QTreeView::columnWidth(int column) const

column 의 너비를 반환합니다.

resizeColumnToContents() 및 setColumnWidth()도 참조하십시오 .

[override virtual protected] void QTreeView::currentChanged(const QModelIndex &current, const QModelIndex &previous)

QAbstractItemView::currentChanged(const QModelIndex &current, const QModelIndex &previous)를 재구현합니다.

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

QAbstractItemView::dataChanged(const QModelIndex &topLeft, const QModelIndex &bottomRight, const QList<int> &roles)를 재구현합니다.

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

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

[virtual protected] void QTreeView::drawBranches(QPainter *painter, const QRect &rect, const QModelIndex &index) const

지정된 painter 를 사용하여 트리 뷰에서 모델 항목 index 과 같은 행에 브랜치를 그립니다. 브랜치는 rect 로 지정된 사각형 내에 그려집니다.

[virtual protected] void QTreeView::drawRow(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const

지정된 painter 을 사용하여 트리 뷰에서 모델 항목 index 을 포함하는 행을 그립니다. option 은 항목이 표시되는 방식을 제어합니다.

setAlternatingRowColors()도 참조하십시오 .

[protected] void QTreeView::drawTree(QPainter *painter, const QRegion &region) const

지정된 region 와 교차하는 트리 부분을, 지정된 painter 를 사용하여 그립니다.

paintEvent()도 참조하십시오 .

[slot] void QTreeView::expand(const QModelIndex &index)

index 로 지정된 모델 항목을 확장합니다.

expanded()도 참조하십시오 .

[slot] void QTreeView::expandAll()

확장 가능한 항목을 모두 확장합니다.

관련 항목: collapseAll(), expand(), collapse(), setExpanded().

[slot] void QTreeView::expandRecursively(const QModelIndex &index, int depth = -1)

지정된 index 에 있는 항목과 그 모든 자식 노드를 지정된 depth 까지 확장합니다. depth 는 지정된 index 를 기준으로 합니다. depth 값이 -1이면 모든 자식 노드가 확장되고, depth 값이 0이면 지정된 index 만 확장됩니다.

참조: expandAll().

[slot] void QTreeView::expandToDepth(int depth)

지정된 depth 로 확장 가능한 모든 항목을 확장합니다.

관련 항목: expandAll(), collapseAll(), expand(), collapse(), setExpanded().

[signal] void QTreeView::expanded(const QModelIndex &index)

index 로 지정된 항목이 확장될 때 이 신호가 발생합니다.

setExpanded()도 참조하십시오 .

QHeaderView *QTreeView::header() const

트리 뷰의 헤더를 반환합니다.

setHeader() 및 QAbstractItemModel::headerData()도 참조하십시오 .

[slot] void QTreeView::hideColumn(int column)

지정된 column 를 숨깁니다.

showColumn() 및 setColumnHidden()함수도 참조하십시오 .

[override virtual protected] int QTreeView::horizontalOffset() const

QAbstractItemView::horizontalOffset() const를 재구현합니다.

트리 뷰 내 항목들의 수평 오프셋을 반환합니다.

트리 뷰는 가로 방향 헤더 섹션의 위치를 사용하여 뷰 내 열의 위치를 결정한다는 점에 유의하십시오.

verticalOffset()도 참조하십시오 .

QModelIndex QTreeView::indexAbove(const QModelIndex &index) const

index 보다 위에 있는 항목의 모델 인덱스를 반환합니다.

[override virtual] QModelIndex QTreeView::indexAt(const QPoint &point) const

QAbstractItemView::indexAt(const QPoint &point) const를 재구현합니다.

QModelIndex QTreeView::indexBelow(const QModelIndex &index) const

index 아래에 있는 항목의 모델 인덱스를 반환합니다.

[protected] int QTreeView::indexRowSizeHint(const QModelIndex &index) const

index 로 지정된 행에 대한 크기 힌트를 반환합니다.

sizeHintForColumn() 및 uniformRowHeights()도 참조하십시오 .

bool QTreeView::isColumnHidden(int column) const

column 가 숨겨져 있으면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

hideColumn() 및 isRowHidden()도 참조하십시오 .

bool QTreeView::isExpanded(const QModelIndex &index) const

모델 항목 index 이 확장된 경우 true 을 반환하고, 그렇지 않은 경우 false를 반환합니다.

expand(), expanded() 및 setExpanded()도 참조하십시오 .

bool QTreeView::isFirstColumnSpanned(int row, const QModelIndex &parent) const

parent 의 주어진 row 에서 첫 번째 열에 있는 항목이 모든 열에 걸쳐 있는 경우 true 을 반환하고, 그렇지 않은 경우 false 을 반환합니다.

setFirstColumnSpanned()도 참조하십시오 .

[override virtual protected] bool QTreeView::isIndexHidden(const QModelIndex &index) const

QAbstractItemView::isIndexHidden(const QModelIndex &index) const를 재구현합니다.

bool QTreeView::isRowHidden(int row, const QModelIndex &parent) const

parent 의 지정된 row 에 있는 항목이 숨겨져 있으면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

setRowHidden() 및 isColumnHidden()도 참조하십시오 .

[since 6.12] QRect QTreeView::itemDecorationRect(const QModelIndex &index) const

index 에 있는 항목의 확장/축소 표시기가 차지하는 사각형을 반환합니다. 항목에 자식 요소가 없거나 루트 장식이 비활성화되어 있는 등 해당 표시기가 없는 경우, 반환된 사각형은 유효하지 않습니다. 유효하지 않은 index 도 유효하지 않은 사각형을 반환합니다.

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

visualRect() 및 QStyle::SE_TreeViewDisclosureItem도 참조하십시오 .

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

QAbstractItemView::keyPressEvent(QKeyEvent *event)를 재구현합니다.

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

QAbstractItemView::keyboardSearch(const QString &search)를 재구현합니다.

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

QAbstractItemView::mouseDoubleClickEvent(QMouseEvent *event)을 재구현합니다.

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

QAbstractItemView::mouseMoveEvent(QMouseEvent *event)를 재구현합니다.

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

QAbstractItemView::mousePressEvent(QMouseEvent *event)를 재구현합니다.

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

QAbstractItemView::mouseReleaseEvent(QMouseEvent *event)를 재구현합니다.

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

다음 함수를 재구현합니다: QAbstractItemView::moveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers).

버튼 modifiers 에서 제공된 정보를 사용하여, cursorAction 에 설명된 방식대로 커서를 이동합니다.

[override virtual protected] void QTreeView::paintEvent(QPaintEvent *event)

QAbstractScrollArea::paintEvent(QPaintEvent *event)를 재구현합니다.

[override virtual] void QTreeView::reset()

QAbstractItemView::reset()을 재구현합니다.

[slot] void QTreeView::resizeColumnToContents(int column)

지정된 column 의 크기를 해당 콘텐츠의 크기에 맞게 조정합니다.

columnWidth(), setColumnWidth(), sizeHintForColumn(), QHeaderView::resizeContentsPrecision()도 참조하십시오 .

[protected] int QTreeView::rowHeight(const QModelIndex &index) const

주어진 index 로 지정된 행의 높이를 반환합니다.

indexRowSizeHint()도 참조하십시오 .

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

QAbstractItemView::rowsAboutToBeRemoved(const QModelIndex &parent, int start, int end)를 재구현합니다.

뷰에, start 행부터 end 행까지(해당 행 포함)의 행들이 지정된 parent 모델 항목에서 곧 제거될 것임을 알립니다.

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

QAbstractItemView::rowsInserted(const QModelIndex &parent, int start, int end)를 재구현합니다.

start 행부터 end 행까지(해당 행 포함)의 행들이 parent 모델 항목에 삽입되었음을 뷰에 알립니다.

[protected slot] void QTreeView::rowsRemoved(const QModelIndex &parent, int start, int end)

start 행부터 end 행까지(해당 행 포함)의 행이 지정된 parent 모델 항목에서 제거되었음을 뷰에 알립니다.

[override virtual protected] void QTreeView::scrollContentsBy(int dx, int dy)

QAbstractScrollArea::scrollContentsBy(int dx, int dy)를 재구현합니다.

트리 뷰의 내용을 (dx, dy)만큼 스크롤합니다.

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

QAbstractItemView::scrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint)를 재구현합니다.

지정된 모델 항목 index 이 표시될 때까지 트리 뷰의 내용을 스크롤합니다. hint 매개변수는 작업 후 해당 항목이 위치해야 할 위치를 더 정확하게 지정합니다. 모델 항목의 부모 중 접혀 있는 것이 있다면, 해당 모델 항목이 표시되도록 해당 부모를 펼칩니다.

[override virtual] void QTreeView::selectAll()

QAbstractItemView::selectAll()을 재구현합니다.

[override virtual protected] QModelIndexList QTreeView::selectedIndexes() const

QAbstractItemView::selectedIndexes() const를 재구현합니다.

[override virtual protected] void QTreeView::selectionChanged(const QItemSelection &selected, const QItemSelection &deselected)

QAbstractItemView::selectionChanged(const QItemSelection &selected, const QItemSelection &deselected)를 재구현합니다.

void QTreeView::setColumnHidden(int column, bool hide)

hide 가 true인 경우 column 가 숨겨지고, 그렇지 않은 경우 column 가 표시됩니다.

isColumnHidden(), hideColumn(), setRowHidden()도 참조하십시오 .

void QTreeView::setColumnWidth(int column, int width)

지정된 ` column `의 너비를 ` width `로 설정합니다.

columnWidth() 및 resizeColumnToContents()도 참조하십시오 .

void QTreeView::setExpanded(const QModelIndex &index, bool expanded)

expanded 의 값에 따라 index 가 가리키는 항목을 접힌 상태 또는 펼쳐진 상태로 설정합니다.

expanded(), expand(), isExpanded()도 참조하십시오 .

void QTreeView::setFirstColumnSpanned(int row, const QModelIndex &parent, bool span)

span 가 true인 경우, row 의 첫 번째 열에 있는 지정된 parent 을 가진 항목이 모든 열에 걸쳐 표시되도록 설정되며, 그렇지 않은 경우 row 에 있는 모든 항목이 표시됩니다.

isFirstColumnSpanned()도 참조하십시오 .

void QTreeView::setHeader(QHeaderView *header)

트리 뷰의 헤더를 지정된 ` header`로 설정합니다.

뷰는 지정된 ` header `에 대한 소유권을 인수하며, 새로운 헤더가 설정되면 이를 삭제합니다.

QAbstractItemModel::headerData()도 참조하십시오 .

[override virtual] void QTreeView::setModel(QAbstractItemModel *model)

QAbstractItemView::setModel(QAbstractItemModel *model)을 재구현합니다.

[override virtual] void QTreeView::setRootIndex(const QModelIndex &index)

QAbstractItemView::setRootIndex(const QModelIndex &index)를 재구현합니다.

void QTreeView::setRowHidden(int row, const QModelIndex &parent, bool hide)

hide 가 true인 경우, 지정된 parent 를 가진 row 가 숨겨지고, 그렇지 않은 경우 row 가 표시됩니다.

isRowHidden() 및 setColumnHidden()도 참조하십시오 .

[override virtual protected] void QTreeView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags command)

QAbstractItemView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags flags)를 재구현합니다.

command 선택 범위를 사각형 내부 또는 사각형에 닿는 항목들에 적용합니다. rect.

selectionCommand()도 참조하십시오 .

[override virtual] void QTreeView::setSelectionModel(QItemSelectionModel *selectionModel)

QAbstractItemView::setSelectionModel(QItemSelectionModel *selectionModel)을 재구현합니다.

void QTreeView::setTreePosition(int index)

이는 트리 구조가 논리적 인덱스 index 에 배치되어야 함을 지정합니다. 가 -1로 설정된 경우, 트리는 항상 시각적 인덱스 0을 따릅니다.

treePosition(), QHeaderView::swapSections(), QHeaderView::moveSection()도 참조하십시오 .

[slot] void QTreeView::showColumn(int column)

지정된 column 를 트리 뷰에 표시합니다.

hideColumn() 및 setColumnHidden()도 참조하십시오 .

[override virtual protected] int QTreeView::sizeHintForColumn(int column) const

재구현: ` QAbstractItemView::sizeHintForColumn(int column) const`.

column 의 너비에 대한 크기 힌트를 반환하거나, 모델이 없는 경우 -1을 반환합니다.

특정 열의 너비를 고정된 값으로 설정해야 하는 경우, 뷰의 헤더에서 QHeaderView::resizeSection()를 호출하십시오.

서브클래스에서 이 함수를 재구현하는 경우, 반환하는 값은 resizeColumnToContents()이 호출될 때만 사용된다는 점에 유의하십시오. 이 경우, 뷰의 헤더나 항목 델리게이트 중 하나에서 더 넓은 열 너비가 요구되면, 대신 그 너비가 사용됩니다.

QWidget::sizeHint, header(), QHeaderView::resizeContentsPrecision()도 참조하십시오 .

[slot] void QTreeView::sortByColumn(int column, Qt::SortOrder order)

지정된 ` column ` 및 ` order`의 값을 기준으로 모델을 정렬합니다.

column -1일 수 있으며, 이 경우 정렬 표시기가 표시되지 않고 모델은 정렬되지 않은 원래 순서로 돌아갑니다. 모든 모델이 이 기능을 지원하는 것은 아니며, 이 경우 프로그램이 중단될 수도 있습니다.

sortingEnabled도 참조하십시오 .

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

QAbstractItemView::timerEvent(QTimerEvent *event)를 재구현합니다.

int QTreeView::treePosition() const

트리가 설정된 논리 인덱스를 반환합니다. 반환 값이 -1이면 트리는 시각적 인덱스 0에 배치됩니다.

setTreePosition()도 참조하십시오 .

[override virtual protected] void QTreeView::updateGeometries()

QAbstractItemView::updateGeometries()을 재구현합니다.

[override virtual protected] int QTreeView::verticalOffset() const

QAbstractItemView::verticalOffset() const를 재구현합니다.

트리 뷰 내 항목들의 수직 오프셋을 반환합니다.

horizontalOffset()도 참조하십시오 .

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

QAbstractItemView::viewportEvent(QEvent *event)를 재구현합니다.

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

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

[override virtual] QRect QTreeView::visualRect(const QModelIndex &index) const

QAbstractItemView::visualRect(const QModelIndex &index) const를 재구현합니다.

index 에서 항목이 차지하는 뷰포트의 직사각형을 반환합니다. 인덱스가 표시되지 않거나 명시적으로 숨겨진 경우, 반환된 직사각형은 유효하지 않습니다.

itemDecorationRect()도 참조하십시오 .

[override virtual protected] QRegion QTreeView::visualRegionForSelection(const QItemSelection &selection) const

QAbstractItemView::visualRegionForSelection(const QItemSelection &selection) const를 재구현합니다.

주어진 selection 에 포함된 항목들의 뷰포트에서 사각형을 반환합니다.

4.7 버전부터 반환되는 영역에는 뷰포트와 교차하거나 뷰포트에 포함된 사각형만 포함됩니다.