QTreeView Class

QTreeView 클래스는 트리 뷰의 기본 모델/뷰 구현을 제공합니다. 더 보기...

Header: #include <QTreeView>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
상속합니다: QAbstractItemView
상속 대상

QHelpContentWidgetQTreeWidget

속성

공용 함수

QTreeView(QWidget *parent = nullptr)
virtual ~QTreeView()
bool allColumnsShowFocus() const
int autoExpandDelay() const
int columnAt(int x) const
int columnViewportPosition(int column) const
int columnWidth(int column) const
bool expandsOnDoubleClick() const
QHeaderView *header() const
int indentation() const
QModelIndex indexAbove(const QModelIndex &index) const
QModelIndex indexBelow(const QModelIndex &index) const
bool isAnimated() const
bool isColumnHidden(int column) const
bool isExpanded(const QModelIndex &index) const
bool isFirstColumnSpanned(int row, const QModelIndex &parent) const
bool isHeaderHidden() const
bool isRowHidden(int row, const QModelIndex &parent) const
bool isSortingEnabled() const
bool itemsExpandable() const
void resetIndentation()
bool rootIsDecorated() const
void setAllColumnsShowFocus(bool enable)
void setAnimated(bool enable)
void setAutoExpandDelay(int delay)
void setColumnHidden(int column, bool hide)
void setColumnWidth(int column, int width)
void setExpanded(const QModelIndex &index, bool expanded)
void setExpandsOnDoubleClick(bool enable)
void setFirstColumnSpanned(int row, const QModelIndex &parent, bool span)
void setHeader(QHeaderView *header)
void setHeaderHidden(bool hide)
void setIndentation(int i)
void setItemsExpandable(bool enable)
void setRootIsDecorated(bool show)
void setRowHidden(int row, const QModelIndex &parent, bool hide)
void setSortingEnabled(bool enable)
void setTreePosition(int index)
void setUniformRowHeights(bool uniform)
void setWordWrap(bool on)
int treePosition() const
bool uniformRowHeights() const
bool wordWrap() const

재구현된 공용 함수

virtual void dataChanged(const QModelIndex &topLeft, const QModelIndex &bottomRight, const QList<int> &roles = QList<int>()) override
virtual QModelIndex indexAt(const QPoint &point) const override
virtual void keyboardSearch(const QString &search) override
virtual void reset() override
virtual void scrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint = EnsureVisible) override
virtual void selectAll() override
virtual void setModel(QAbstractItemModel *model) override
virtual void setRootIndex(const QModelIndex &index) override
virtual void setSelectionModel(QItemSelectionModel *selectionModel) override
virtual QRect visualRect(const QModelIndex &index) const override

공용 슬롯

void collapse(const QModelIndex &index)
void collapseAll()
void expand(const QModelIndex &index)
void expandAll()
void expandRecursively(const QModelIndex &index, int depth = -1)
void expandToDepth(int depth)
void hideColumn(int column)
void resizeColumnToContents(int column)
void showColumn(int column)
void sortByColumn(int column, Qt::SortOrder order)

신호

void collapsed(const QModelIndex &index)
void expanded(const QModelIndex &index)

보호된 함수

virtual void drawBranches(QPainter *painter, const QRect &rect, const QModelIndex &index) const
virtual void drawRow(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const
void drawTree(QPainter *painter, const QRegion &region) const
int indexRowSizeHint(const QModelIndex &index) const
int rowHeight(const QModelIndex &index) const

재구현된 보호 함수

virtual void changeEvent(QEvent *event) override
virtual void currentChanged(const QModelIndex &current, const QModelIndex &previous) override
virtual void dragMoveEvent(QDragMoveEvent *event) override
virtual int horizontalOffset() const override
virtual bool isIndexHidden(const QModelIndex &index) const override
virtual void keyPressEvent(QKeyEvent *event) override
virtual void mouseDoubleClickEvent(QMouseEvent *event) override
virtual void mouseMoveEvent(QMouseEvent *event) override
virtual void mousePressEvent(QMouseEvent *event) override
virtual void mouseReleaseEvent(QMouseEvent *event) override
virtual QModelIndex moveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers) override
virtual void paintEvent(QPaintEvent *event) override
virtual void rowsAboutToBeRemoved(const QModelIndex &parent, int start, int end) override
virtual void rowsInserted(const QModelIndex &parent, int start, int end) override
virtual void scrollContentsBy(int dx, int dy) override
virtual QModelIndexList selectedIndexes() const override
virtual void selectionChanged(const QItemSelection &selected, const QItemSelection &deselected) override
virtual void setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags command) override
virtual int sizeHintForColumn(int column) const override
virtual void timerEvent(QTimerEvent *event) override
virtual void updateGeometries() override
virtual int verticalOffset() const override
virtual bool viewportEvent(QEvent *event) override
virtual QSize viewportSizeHint() const override
virtual QRegion visualRegionForSelection(const QItemSelection &selection) const override

보호된 슬롯

void columnCountChanged(int oldCount, int newCount)
void columnMoved()
void columnResized(int column, int oldSize, int newSize)
void rowsRemoved(const QModelIndex &parent, int start, int end)

상세 설명

QTreeView는 모델에서 항목의 트리 표현을 구현합니다. 이 클래스는 이전에 QListView 클래스에서 제공했던 표준 계층 목록을 제공하는 데 사용되지만, Qt의 모델/뷰 아키텍처가 제공하는 보다 유연한 접근 방식을 사용합니다.

QTreeView 클래스는 모델/뷰 클래스 중 하나이며 Qt의 모델/뷰 프레임워크의 일부입니다.

QTreeView는 QAbstractItemView 클래스에 정의된 인터페이스를 구현하여 QAbstractItemModel 클래스에서 파생된 모델에서 제공하는 데이터를 표시할 수 있도록 합니다.

모델의 데이터를 표시하는 트리 뷰를 구성하는 것은 간단합니다. 다음 예에서는 QFileSystemModel 에서 제공된 디렉터리의 내용을 트리로 표시합니다:

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

모델/뷰 아키텍처는 모델이 변경되면 트리 보기의 콘텐츠가 업데이트되도록 합니다.

하위 항목이 있는 항목은 확장(하위 항목이 표시됨) 또는 축소(하위 항목이 숨겨짐) 상태일 수 있습니다. 이 상태가 변경되면 해당 항목의 모델 인덱스와 함께 collapsed() 또는 expanded() 신호가 전송됩니다.

계층 수준을 나타내는 데 사용되는 들여쓰기의 양은 indentation 속성에 의해 제어됩니다.

트리 보기의 헤더는 QHeaderView 클래스를 사용하여 구성되며 header()->hide() 을 사용하여 숨길 수 있습니다. 각 헤더는 stretchLastSection 속성을 true로 설정하여 구성되므로 뷰가 헤더에 할당된 공간을 낭비하지 않습니다. 이 값을 true로 설정하면 이 속성이 머리글의 마지막 섹션에 설정된 크기 조정 모드를 재정의합니다.

기본적으로 트리 보기의 모든 열은 첫 번째 열을 제외하고 이동할 수 있습니다. 이러한 열의 이동을 비활성화하려면 QHeaderViewsetSectionsMovable() 함수를 사용합니다. 섹션 재정렬에 대한 자세한 내용은 Moving Header Sections 을 참조하세요.

키 바인딩

QTreeView는 사용자가 뷰를 탐색하고 항목의 콘텐츠와 상호 작용할 수 있도록 하는 일련의 키 바인딩을 지원합니다:

Action
Up이전 행의 같은 열에 있는 항목으로 커서를 이동합니다. 현재 항목의 부모 항목에 더 이상 탐색할 행이 없는 경우 커서는 부모 항목 앞의 형제 항목의 마지막 행에 있는 관련 항목으로 이동합니다.
아래로커서를 다음 행의 같은 열에 있는 항목으로 이동합니다. 현재 항목의 상위 항목에 더 이상 탐색할 행이 없는 경우 커서는 상위 항목 뒤에 있는 형제 항목의 첫 번째 행에 있는 관련 항목으로 이동합니다.
왼쪽분기를 축소하여 현재 항목의 하위 항목(있는 경우)을 숨깁니다.
Minus왼쪽과 동일합니다.
오른쪽분기를 확장하여 현재 항목의 자식(있는 경우)을 표시합니다.
플러스오른쪽과 동일합니다.
별표현재 항목과 모든 하위 항목(있는 경우)을 펼칩니다.
페이지 위로커서를 한 페이지 위로 이동합니다.
PageDown커서를 한 페이지 아래로 이동합니다.
모델에서 첫 번째 최상위 항목의 첫 번째 행과 같은 열에 있는 항목으로 커서를 이동합니다.
모델에서 마지막 최상위 항목의 마지막 행과 같은 열에 있는 항목으로 커서를 이동합니다.
F2편집 가능한 모델에서 편집할 현재 항목을 엽니다. Escape 키를 사용하여 편집 프로세스를 취소하고 표시된 데이터의 변경 사항을 되돌릴 수 있습니다.

성능 향상

많은 수의 항목을 표시할 때 성능을 개선하기 위해 뷰에 처리 중인 데이터에 대한 힌트를 제공할 수 있습니다. 동일한 높이의 항목을 표시하려는 뷰에 대해 취할 수 있는 한 가지 접근 방식은 uniformRowHeights 속성을 true로 설정하는 것입니다.

QListView, QTreeWidget, 뷰 클래스, QAbstractItemModel, 및 QAbstractItemView참조하십시오 .

속성 문서

allColumnsShowFocus : bool

이 속성은 항목에 모든 열을 사용하여 키보드 포커스를 표시할지 여부를 나타냅니다.

이 속성이 true 인 경우 모든 열에 포커스가 표시되고, 그렇지 않으면 하나의 열에만 포커스가 표시됩니다.

기본값은 false입니다.

액세스 함수:

bool allColumnsShowFocus() const
void setAllColumnsShowFocus(bool enable)

animated : bool

이 속성은 애니메이션 활성화 여부를 보유합니다.

이 속성이 true 인 경우 트리뷰는 가지의 확장 및 축소에 애니메이션을 적용합니다. 이 속성이 false 인 경우 트리뷰는 애니메이션을 표시하지 않고 즉시 분기를 확장하거나 축소합니다.

기본적으로 이 속성은 false 입니다.

함수 액세스:

bool isAnimated() const
void setAnimated(bool enable)

autoExpandDelay : int

이 속성은 끌어서 놓기 작업 중에 트리의 항목이 열리기까지의 지연 시간을 저장합니다.

이 속성은 노드가 자동으로 열리기 전에 사용자가 노드 위에서 기다려야 하는 시간(밀리초)을 보유합니다. 시간이 0보다 작게 설정되면 활성화되지 않습니다.

기본적으로 이 속성의 값은 -1이며, 이는 자동 확장이 비활성화되어 있음을 의미합니다.

함수 액세스:

int autoExpandDelay() const
void setAutoExpandDelay(int delay)

expandsOnDoubleClick : bool

이 속성은 항목을 두 번 클릭하여 확장할 수 있는지 여부를 저장합니다.

이 속성은 사용자가 항목을 두 번 클릭하여 확장 및 축소할 수 있는지 여부를 저장합니다. 기본값은 true입니다.

액세스 함수:

bool expandsOnDoubleClick() const
void setExpandsOnDoubleClick(bool enable)

itemsExpandable참조하세요 .

headerHidden : bool

이 속성은 헤더가 표시되는지 여부를 저장합니다.

이 속성이 true 인 경우 헤더가 표시되지 않으며, 그렇지 않으면 표시됩니다. 기본값은 false입니다.

함수에 액세스합니다:

bool isHeaderHidden() const
void setHeaderHidden(bool hide)

header()도 참조하세요 .

indentation : int

트리 보기에서 항목의 들여쓰기.

이 속성은 트리 보기의 각 레벨에 대한 항목의 픽셀 단위로 측정된 들여쓰기를 저장합니다. 최상위 항목의 경우 들여쓰기는 뷰포트 가장자리에서 첫 번째 열의 항목까지의 수평 거리를 지정하고, 자식 항목의 경우 부모 항목으로부터의 들여쓰기를 지정합니다.

기본적으로 이 속성의 값은 스타일에 따라 달라집니다. 따라서 스타일이 변경되면 이 속성이 업데이트됩니다. setIndentation()을 호출하면 업데이트가 중지되고, resetIndentation()을 호출하면 기본 동작이 복원됩니다.

함수에 액세스합니다:

int indentation() const
void setIndentation(int i)
void resetIndentation()

itemsExpandable : bool

이 속성은 사용자가 항목을 확장할 수 있는지 여부를 나타냅니다.

이 속성은 사용자가 항목을 대화형으로 확장 및 축소할 수 있는지 여부를 저장합니다.

기본적으로 이 속성은 true 입니다.

액세스 함수:

bool itemsExpandable() const
void setItemsExpandable(bool enable)

rootIsDecorated : bool

이 속성은 최상위 항목을 확장 및 축소하는 컨트롤을 표시할지 여부를 결정합니다.

일반적으로 자식이 있는 항목에는 확장 및 축소 컨트롤이 표시되어 자식을 표시하거나 숨길 수 있습니다. 이 속성이 거짓이면 최상위 항목에 이러한 컨트롤이 표시되지 않습니다. 이 속성은 단일 레벨 트리 구조를 단순한 항목 목록처럼 보이게 하는 데 사용할 수 있습니다.

기본적으로 이 속성은 true 입니다.

기능에 액세스합니다:

bool rootIsDecorated() const
void setRootIsDecorated(bool show)

sortingEnabled : bool

이 속성은 정렬이 활성화되었는지 여부를 보유합니다.

이 속성이 true 인 경우 트리에 정렬이 활성화되고, 속성이 false인 경우 정렬이 활성화되지 않습니다. 기본값은 false입니다.

참고: 성능 문제를 방지하려면 트리에 항목을 삽입한 후에 정렬을 활성화하는 것이 좋습니다. 또는 트리에 항목을 삽입하기 전에 목록에 항목을 삽입할 수도 있습니다.

함수 액세스:

bool isSortingEnabled() const
void setSortingEnabled(bool enable)

sortByColumn()도 참조하세요 .

uniformRowHeights : bool

이 속성은 트리 뷰의 모든 항목의 높이가 동일한지 여부를 유지합니다.

이 속성은 뷰의 모든 항목의 높이가 동일한 것이 보장되는 경우에만 true로 설정해야 합니다. 이렇게 하면 뷰에서 일부 최적화를 수행할 수 있습니다.

높이는 뷰의 첫 번째 항목에서 가져옵니다. 해당 항목의 데이터가 변경되면 업데이트됩니다.

참고: 편집기 크기 힌트가 셀 크기 힌트보다 큰 경우 편집기의 크기 힌트가 사용됩니다.

기본적으로 이 속성은 false 입니다.

기능에 액세스합니다:

bool uniformRowHeights() const
void setUniformRowHeights(bool uniform)

wordWrap : bool

이 속성은 항목 텍스트 단어 줄 바꿈 정책을 보유합니다.

이 속성이 true 인 경우 항목 텍스트는 단어 나누기에서 필요한 곳에 줄 바꿈되고, 그렇지 않으면 전혀 줄 바꿈되지 않습니다. 이 속성은 기본적으로 false 입니다.

줄 바꿈이 활성화되어 있어도 셀이 모든 텍스트에 맞게 확장되지는 않습니다. 줄임표는 현재 textElideMode 에 따라 삽입됩니다.

액세스 함수:

bool wordWrap() const
void setWordWrap(bool on)

멤버 함수 문서

[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 의 크기가 변경될 때마다 호출됩니다. oldSizenewSize 는 이전 크기와 새 크기를 픽셀 단위로 제공합니다.

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 * 이벤트).

[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

지정된 painter 을 사용하여 주어진 region 과 교차하는 트리의 일부를 그립니다.

paintEvent()도 참조하세요 .

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

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

expanded()도 참조하세요 .

[slot] void QTreeView::expandAll()

확장 가능한 모든 항목을 펼칩니다.

참고: 이 함수는 fetch more 데이터를 시도하지 않습니다.

경고: 모델에 많은 수의 항목이 포함된 경우 이 함수를 실행하는 데 시간이 다소 걸립니다.

collapseAll(), expand(), collapse() 및 setExpanded()도 참조하세요 .

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

지정된 index 의 항목과 모든 하위 항목을 지정된 depth 으로 확장합니다. depth 은 주어진 index 에 상대적입니다. depth 이 -1이면 모든 하위 항목이 확장되고 depth 이 0이면 지정된 index 만 확장됩니다.

참고: 이 함수는 fetch more 데이터를 시도하지 않습니다.

경고: 모델에 많은 수의 항목이 포함된 경우 이 함수를 실행하는 데 시간이 다소 걸립니다.

expandAll()도 참조하세요 .

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

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

참고: 이 함수는 fetch more 데이터를 시도하지 않습니다.

expandAll(), collapseAll(), expand(), collapse() 및 setExpanded()도 참조하세요 .

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

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

setExpanded()도 참조하세요 .

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

setHeader() 및 QAbstractItemModel::headerData()도 참조하세요 .

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

지정된 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()도 참조하세요 .

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

다시 구현합니다: QAbstractItemView::keyPressEvent(QKeyEvent * 이벤트).

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

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

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

다시 구현합니다: QAbstractItemView::mouseDoubleClickEvent(QMouseEvent * 이벤트).

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

다시 구현합니다: QAbstractItemView::mouseMoveEvent(QMouseEvent * 이벤트).

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

다시 구현합니다: QAbstractItemView::mousePressEvent(QMouseEvent * 이벤트).

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

다시 구현합니다: QAbstractItemView::mouseReleaseEvent(QMouseEvent * 이벤트).

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

재구현합니다: QAbstractItemView::moveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers 수정자).

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

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

다시 구현합니다: QAbstractScrollArea::paintEvent(QPaintEvent * 이벤트).

[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).

지정된 parent 모델 항목에서 start 행에서 end 행을 포함하는 행이 곧 제거될 것임을 뷰에 알립니다.

[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)

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

[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 힌트).

지정된 모델 항목 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 이 참이면 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 이 참이면 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 이 참이면 지정된 parent 이 있는 row 이 숨겨지고, 그렇지 않으면 row 이 표시됩니다.

isRowHidden() 및 setColumnHidden()도 참조하세요 .

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

재구현합니다: QAbstractItemView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags 플래그).

사각형 안에 있거나 사각형에 의해 터치된 항목에 command 선택을 적용합니다( rect).

selectionCommand()도 참조하세요 .

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

다시 구현합니다: QAbstractItemView::setSelectionModel(QItemSelectionModel *셀렉션모델).

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)

주어진 columnorder 의 값에 따라 모델을 정렬합니다.

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

sortingEnabled참조하세요 .

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

다시 구현합니다: QAbstractItemView::timerEvent(Q타이머이벤트 *이벤트).

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 * 이벤트).

[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 에서 항목이 차지하고 있는 뷰포트의 사각형을 반환합니다. 인덱스가 보이지 않거나 명시적으로 숨겨져 있으면 반환된 사각형은 유효하지 않습니다.

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

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

지정된 selection 에 있는 항목의 뷰포트에서 직사각형을 리턴합니다.

4.7부터 반환되는 영역은 뷰포트와 교차하는(또는 뷰포트에 포함된) 사각형만 포함합니다.

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.