QTreeWidget Class

auto *treeWidget = new QTreeWidget();
treeWidget->setColumnCount(1);
for (int i = 0; i < 10; ++i)
    new QTreeWidgetItem(treeWidget, { tr("item: %1").arg(i) });

멤버 함수 설명서

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

지정된 ` parent`을 사용하여 트리 위젯을 생성합니다.

[virtual noexcept] QTreeWidget::~QTreeWidget()

트리 위젯과 그 안에 포함된 모든 항목을 삭제합니다.

void QTreeWidget::addTopLevelItem(QTreeWidgetItem *item)

item 를 위젯의 최상위 항목으로 추가합니다.

insertTopLevelItem()도 참조하십시오 .

void QTreeWidget::addTopLevelItems(const QList<QTreeWidgetItem *> &items)

items 목록을 위젯의 최상위 항목으로 추가합니다.

insertTopLevelItems()도 참조하십시오 .

[slot] void QTreeWidget::clear()

트리 위젯의 모든 항목과 선택 항목을 제거하여 트리 위젯을 초기화합니다.

참고: 각 항목은 삭제되기 전에 트리 위젯에서 먼저 제거되므로, 항목의 소멸자 내에서 QTreeWidgetItem::treeWidget()을 호출할 경우 반환값이 유효하지 않게 됩니다.

takeTopLevelItem(), topLevelItemCount(), columnCount()도 참조하십시오 .

void QTreeWidget::closePersistentEditor(QTreeWidgetItem *item, int column = 0)

지정된 column 내의 item 에 대한 상주 편집기를 닫습니다.

이 항목과 열의 조합에 대해 열려 있는 지속형 편집기가 없는 경우, 이 함수는 아무런 효과도 없습니다.

openPersistentEditor() 및 isPersistentEditorOpen()도 참조하십시오 .

[slot] void QTreeWidget::collapseItem(const QTreeWidgetItem *item)

item 를 닫습니다. 이로 인해 해당 항목의 자식 노드를 포함하는 트리가 접힙니다.

expandItem(), currentItem(), itemAt(), topLevelItem()도 참조하십시오 .

int QTreeWidget::currentColumn() const

트리 위젯의 현재 열을 반환합니다.

setCurrentItem() 및 columnCount()도 참조하십시오 .

QTreeWidgetItem *QTreeWidget::currentItem() const

트리 위젯의 현재 항목을 반환합니다.

setCurrentItem() 및 currentItemChanged()도 참조하십시오 .

[signal] void QTreeWidget::currentItemChanged(QTreeWidgetItem *current, QTreeWidgetItem *previous)

이 신호는 현재 항목이 변경될 때 발생합니다. 현재 항목은 ` current`로 지정되며, 이는 ` previous `의 현재 항목을 대체합니다.

setCurrentItem()도 참조하십시오 .

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

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

[virtual protected] bool QTreeWidget::dropMimeData(QTreeWidgetItem *parent, int index, const QMimeData *data, Qt::DropAction action)

지정된 parent 항목의 index 에서, 지정된 action 로 종료된 드래그 앤 드롭 작업에 의해 제공된 data 를 처리합니다.

기본 구현은 MIME 데이터를 디코딩하여 모델에 삽입함으로써 드롭이 성공적으로 처리된 경우 ` true `를 반환하고, 그렇지 않은 경우 ` false`를 반환합니다.

supportedDropActions() 및 supportedDragActions도 참조하십시오 .

void QTreeWidget::editItem(QTreeWidgetItem *item, int column = 0)

지정된 column 에 있는 ‘ item ’ 파일이 편집 가능한 경우, 해당 파일의 편집을 시작합니다.

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

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

[slot] void QTreeWidget::expandItem(const QTreeWidgetItem *item)

item 를 확장합니다. 이로 인해 항목의 자식 노드를 포함하는 트리가 확장됩니다.

collapseItem(), currentItem(), itemAt(), topLevelItem() 및 itemExpanded()도 참조하십시오 .

QList<QTreeWidgetItem *> QTreeWidget::findItems(const QString &text, Qt::MatchFlags flags, int column = 0) const

주어진 ` text`에 일치하고, 주어진 ` flags`을 사용하며, 주어진 ` column`에 포함된 항목들의 목록을 반환합니다.

QTreeWidgetItem *QTreeWidget::headerItem() const

트리 위젯의 헤더에 사용되는 항목을 반환합니다.

setHeaderItem()도 참조하십시오 .

QModelIndex QTreeWidget::indexFromItem(const QTreeWidgetItem *item, int column = 0) const

지정된 column 내의 지정된 item 와 연관된 QModelIndex 를 반환합니다.

itemFromIndex() 및 topLevelItem()도 참조하십시오 .

int QTreeWidget::indexOfTopLevelItem(QTreeWidgetItem *item) const

지정된 최상위 item 의 인덱스를 반환하며, 해당 항목을 찾을 수 없는 경우 -1을 반환합니다.

sortItems() 및 topLevelItemCount()도 참조하십시오 .

void QTreeWidget::insertTopLevelItem(int index, QTreeWidgetItem *item)

뷰의 최상위 수준에 index 에 있는 ‘ item ’를 삽입합니다.

해당 항목이 이미 다른 곳에 삽입된 경우, 삽입되지 않습니다.

addTopLevelItem() 및 columnCount()도 참조하십시오 .

void QTreeWidget::insertTopLevelItems(int index, const QList<QTreeWidgetItem *> &items)

index 에 있는 ‘ items ’ 목록을 뷰의 최상위 수준에 삽입합니다.

이미 다른 곳에 삽입된 항목은 삽입되지 않습니다.

addTopLevelItems()도 참조하십시오 .

QTreeWidgetItem *QTreeWidget::invisibleRootItem() const

트리 위젯의 보이지 않는 루트 항목을 반환합니다.

이 보이지 않는 루트 항목을 통해 ` QTreeWidgetItem ` API를 사용하여 트리 위젯의 최상위 항목에 접근할 수 있으므로, 최상위 항목과 그 자식 항목을 일관된 방식으로 처리할 수 있는 함수(예: 재귀 함수)를 작성할 수 있습니다.

bool QTreeWidget::isPersistentEditorOpen(QTreeWidgetItem *item, int column = 0) const

항목 item 의 열 column 에 대해 영구 편집기가 열려 있는지 여부를 반환합니다.

openPersistentEditor() 및 closePersistentEditor()도 참조하십시오 .

QTreeWidgetItem *QTreeWidget::itemAbove(const QTreeWidgetItem *item) const

지정된 ` item` 위의 항목을 반환합니다.

[signal] void QTreeWidget::itemActivated(QTreeWidgetItem *item, int column)

이 신호는 사용자가 항목을 한 번 또는 두 번 클릭(플랫폼에 따라, 즉 QStyle::SH_ItemView_ActivateItemOnSingleClick 스타일 힌트에 따라 다름)하거나 특수 키(예: Enter)를 눌러 항목을 활성화할 때 발생합니다.

지정된 item 는 클릭된 항목을 나타내며, 클릭된 항목이 없는 경우에는 nullptr 입니다. column 는 클릭된 항목의 열을 나타내며, 클릭된 항목이 없는 경우에는 -1입니다.

QTreeWidgetItem *QTreeWidget::itemAt(const QPoint &p) const

p 좌표에 있는 항목에 대한 포인터를 반환합니다. 이 좌표는 트리 위젯의 viewport()을 기준으로 한 상대 좌표입니다.

visualItemRect()도 참조하십시오 .

QTreeWidgetItem *QTreeWidget::itemAt(int x, int y) const

(x, y) 좌표에 있는 항목에 대한 포인터를 반환합니다. 이 좌표는 트리 위젯의 viewport()를 기준으로 한 상대 좌표입니다.

QTreeWidgetItem *QTreeWidget::itemBelow(const QTreeWidgetItem *item) const

지정된 ` item`보다 시각적으로 아래에 위치한 항목을 반환합니다.

[signal] void QTreeWidget::itemChanged(QTreeWidgetItem *item, int column)

지정된 item 내의 column 의 내용이 변경되면 이 신호가 전송됩니다.

[signal] void QTreeWidget::itemClicked(QTreeWidgetItem *item, int column)

사용자가 위젯 내부를 클릭하면 이 신호가 발생합니다.

지정된 ` item `는 클릭된 항목을 나타냅니다. ` column `는 클릭된 항목의 열을 나타냅니다. 클릭된 항목이 없는 경우 신호는 발생하지 않습니다.

[signal] void QTreeWidget::itemCollapsed(QTreeWidgetItem *item)

이 신호는 지정된 item 가 접혀서 그 자식 요소가 하나도 표시되지 않게 될 때 발생합니다.

참조: QTreeWidgetItem::isExpanded(), itemExpanded(), collapseItem().

[signal] void QTreeWidget::itemDoubleClicked(QTreeWidgetItem *item, int column)

사용자가 위젯 내부를 더블 클릭하면 이 신호가 발생합니다.

지정된 ` item `는 클릭된 항목을 나타내며, 클릭된 항목이 없는 경우에는 ` nullptr `가 됩니다. ` column `는 클릭된 항목의 열을 나타냅니다. 어떤 항목도 더블 클릭되지 않은 경우에는 신호가 발생하지 않습니다.

[signal] void QTreeWidget::itemEntered(QTreeWidgetItem *item, int column)

이 신호는 마우스 커서가 지정된 column 위의 item 영역에 진입할 때 발생합니다. 이 기능을 사용하려면 QTreeWidget 마우스 추적 기능이 활성화되어 있어야 합니다.

[signal] void QTreeWidget::itemExpanded(QTreeWidgetItem *item)

이 신호는 지정된 item 가 확장되어 그 모든 자식 요소가 표시될 때 발생합니다.

QTreeWidgetItem::isExpanded(), itemCollapsed(), expandItem()도 참조하십시오 .

QTreeWidgetItem *QTreeWidget::itemFromIndex(const QModelIndex &index) const

주어진 ` index`와 연관된 ` QTreeWidgetItem `에 대한 포인터를 반환합니다.

indexFromItem()도 참조하십시오 .

[signal] void QTreeWidget::itemPressed(QTreeWidgetItem *item, int column)

이 신호는 사용자가 위젯 내부에서 마우스 버튼을 클릭했을 때 발생합니다.

지정된 ` item `는 클릭된 항목을 나타내며, 클릭된 항목이 없는 경우에는 ` nullptr `가 됩니다. ` column `는 클릭된 항목의 열을 나타내며, 클릭된 항목이 없는 경우에는 -1이 됩니다.

[signal] void QTreeWidget::itemSelectionChanged()

이 신호는 트리 위젯에서 선택 항목이 변경될 때 발생합니다. 현재 선택 항목은 ` selectedItems()`를 통해 확인할 수 있습니다.

QWidget *QTreeWidget::itemWidget(QTreeWidgetItem *item, int column) const

item 로 지정된 셀과 주어진 column 에 표시된 위젯을 반환합니다.

setItemWidget() 및 removeItemWidget()도 참조하십시오 .

[virtual protected] QMimeData *QTreeWidget::mimeData(const QList<QTreeWidgetItem *> &items) const

지정된 items 에 대한 직렬화된 설명이 포함된 객체를 반환합니다. 항목을 설명하는 데 사용되는 형식은 mimeTypes() 함수에서 가져옵니다.

항목 목록이 비어 있는 경우, 시리얼화된 빈 목록 대신 nullptr 이 반환됩니다.

[virtual protected] QStringList QTreeWidget::mimeTypes() const

트리 위젯 항목 목록을 설명하는 데 사용할 수 있는 MIME 유형 목록을 반환합니다.

mimeData()도 참조하십시오 .

void QTreeWidget::openPersistentEditor(QTreeWidgetItem *item, int column = 0)

지정된 column 에서 item 용 영구 편집기를 엽니다.

closePersistentEditor() 및 isPersistentEditorOpen()도 참조하십시오 .

void QTreeWidget::removeItemWidget(QTreeWidgetItem *item, int column)

지정된 item 에 설정된 위젯을 지정된 column 에서 제거합니다.

itemWidget() 및 setItemWidget()도 참조하십시오 .

[slot] void QTreeWidget::scrollToItem(const QTreeWidgetItem *item, QAbstractItemView::ScrollHint hint = EnsureVisible)

item 가 표시되도록 보장하며, 필요한 경우 지정된 hint 를 사용하여 뷰를 스크롤합니다.

currentItem(), itemAt() 및 topLevelItem()도 참조하십시오 .

QList<QTreeWidgetItem *> QTreeWidget::selectedItems() const

선택된 숨김 처리되지 않은 모든 항목의 목록을 반환합니다.

itemSelectionChanged()도 참조하십시오 .

void QTreeWidget::setCurrentItem(QTreeWidgetItem *item)

트리 위젯에서 현재 선택 모드( item )를 설정합니다.

선택 모드가 ' NoSelection'가 아닌 경우, 해당 항목도 선택됩니다.

currentItem() 및 currentItemChanged()도 참조하십시오 .

void QTreeWidget::setCurrentItem(QTreeWidgetItem *item, int column)

트리 위젯의 현재 선택된 항목( item )과 현재 열을 column 로 설정합니다.

currentItem()도 참조하십시오 .

void QTreeWidget::setCurrentItem(QTreeWidgetItem *item, int column, QItemSelectionModel::SelectionFlags command)

지정된 command 를 사용하여 트리 위젯의 현재 item 와 현재 열을 column 로 설정합니다.

currentItem()도 참조하십시오 .

void QTreeWidget::setHeaderItem(QTreeWidgetItem *item)

트리 위젯의 헤더 item 를 설정합니다. 헤더의 각 열에 표시될 레이블은 해당 항목의 레이블에서 가져옵니다.

트리 위젯이 해당 항목에 대한 소유권을 갖습니다.

headerItem() 및 setHeaderLabels()도 참조하십시오 .

void QTreeWidget::setHeaderLabel(const QString &label)

setHeaderLabels(QStringList(label))와 동일합니다.

void QTreeWidget::setHeaderLabels(const QStringList &labels)

labels 목록에 있는 각 항목에 대해 헤더에 열을 추가하고, 각 열의 레이블을 설정합니다.

setHeaderLabels()는 기존 열을 제거하지 않는다는 점에 유의하십시오.

setHeaderItem() 및 setHeaderLabel()도 참조하십시오 .

void QTreeWidget::setItemWidget(QTreeWidgetItem *item, int column, QWidget *widget)

지정된 widget 가, 지정된 item 및 column 로 지정한 셀에 표시되도록 설정합니다.

지정된 widget 의 autoFillBackground 속성은 true로 설정되어야 합니다. 그렇지 않으면 위젯의 배경이 투명해져 모델 데이터와 트리 위젯 항목이 모두 표시됩니다.

이 함수는 트리 위젯 항목 대신 정적 콘텐츠를 표시하는 용도로만 사용해야 합니다. 사용자 정의 동적 콘텐츠를 표시하거나 사용자 정의 편집기 위젯을 구현하려면, 대신 QTreeView 를 사용하고 QStyledItemDelegate 를 서브클래스화하십시오.

이 함수는 항목 계층 구조가 설정되기 전에는 호출할 수 없습니다. 즉, ` widget `를 포함할 ` QTreeWidgetItem `가 ` widget `가 설정되기 전에 뷰에 추가되어 있어야 합니다.

itemWidget(), removeItemWidget() 및 델리게이트 클래스항목도 참조하십시오 .

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

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

int QTreeWidget::sortColumn() const

위젯의 내용을 정렬하는 데 사용되는 열을 반환합니다.

sortItems()도 참조하십시오 .

void QTreeWidget::sortItems(int column, Qt::SortOrder order)

지정된 ` order `에 따라 위젯 내의 항목을, 주어진 ` column`의 값을 기준으로 정렬합니다.

sortColumn()도 참조하십시오 .

[virtual protected] Qt::DropActions QTreeWidget::supportedDropActions() const

이 뷰에서 지원하는 드롭 동작을 반환합니다.

Qt::DropActions, supportedDragActions 및 dropMimeData()도 참조하십시오 .

QTreeWidgetItem *QTreeWidget::takeTopLevelItem(int index)

트리에서 지정된 index 에 있는 최상위 항목을 제거하여 반환하고, 그렇지 않은 경우 nullptr 을 반환합니다. ;

insertTopLevelItem(), topLevelItem(), topLevelItemCount()도 참조하십시오 .

QTreeWidgetItem *QTreeWidget::topLevelItem(int index) const

지정된 index 에 있는 최상위 항목을 반환하며, 해당 항목이 존재하지 않으면 nullptr 를 반환합니다.

topLevelItemCount() 및 insertTopLevelItem()도 참조하십시오 .

QRect QTreeWidget::visualItemRect(const QTreeWidgetItem *item) const

item 에서 해당 항목이 뷰포트 내에서 차지하는 직사각형 영역을 반환합니다.

itemAt()도 참조하십시오 .