QColumnView Class
QColumnView 클래스는 컬럼 뷰의 모델/뷰 구현을 제공합니다. 더 보기...
| 헤더: | #include <QColumnView> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| 상속: | QAbstractItemView |
속성
(since 6.11)previewColumnVisible : bool- resizeGripsVisible : bool
공개 함수
| QColumnView(QWidget *parent = nullptr) | |
| virtual | ~QColumnView() |
| QList<int> | columnWidths() const |
| bool | isPreviewColumnVisible() const |
| QWidget * | previewWidget() const |
| bool | resizeGripsVisible() const |
| void | setColumnWidths(const QList<int> &list) |
| void | setPreviewColumnVisible(bool visible) |
| void | setPreviewWidget(QWidget *widget) |
| void | setResizeGripsVisible(bool visible) |
재구현된 공용 함수
| virtual QModelIndex | indexAt(const QPoint &point) const 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 *newSelectionModel) override |
| virtual QSize | sizeHint() const override |
| virtual QRect | visualRect(const QModelIndex &index) const override |
신호
| void | updatePreviewWidget(const QModelIndex &index) |
보호된 함수
| virtual QAbstractItemView * | createColumn(const QModelIndex &index) |
| void | initializeColumn(QAbstractItemView *column) const |
재구현된 보호 함수
| virtual void | currentChanged(const QModelIndex ¤t, const QModelIndex &previous) override |
| virtual int | horizontalOffset() const override |
| virtual bool | isIndexHidden(const QModelIndex &index) const override |
| virtual QModelIndex | moveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers) override |
| virtual void | resizeEvent(QResizeEvent *event) override |
| virtual void | rowsInserted(const QModelIndex &parent, int start, int end) override |
| virtual void | scrollContentsBy(int dx, int dy) override |
| virtual void | setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags command) override |
| virtual int | verticalOffset() const override |
| virtual QRegion | visualRegionForSelection(const QItemSelection &selection) const override |
상세 설명
QColumnView는 트리의 각 계층 구조마다 하나씩, 여러 개의 QListView에 모델을 표시합니다. 이를 때때로 ‘계단식 목록(cascading list)’이라고도 합니다.
QColumnView 클래스는 모델/뷰 클래스 중 하나이며, Qt의 모델/뷰 프레임워크의 일부입니다.
QColumnView는 QAbstractItemView 클래스에서 정의된 인터페이스를 구현하여, QAbstractItemModel 클래스에서 파생된 모델이 제공하는 데이터를 표시할 수 있도록 합니다.

‘모델/뷰 프로그래밍’항목도 참조하십시오 .
속성 문서
[since 6.11] previewColumnVisible : bool
이 속성은 미리보기 열이 표시되는지 여부를 결정합니다.
기본적으로 ` visible `는 true로 설정되어 있습니다.
이 열거형은 Qt 6.11에서 도입되었습니다.
액세스 함수:
| bool | isPreviewColumnVisible() const |
| void | setPreviewColumnVisible(bool visible) |
resizeGripsVisible : bool
이 속성은 목록 보기에 크기 조정 손잡이를 표시할지 여부를 지정하는 역할을 합니다.
기본적으로 ` visible `는 `true`로 설정되어 있습니다.
액세스 함수:
| bool | resizeGripsVisible() const |
| void | setResizeGripsVisible(bool visible) |
setRootIndex()도 참조하십시오 .
멤버 함수 문서
[explicit] QColumnView::QColumnView(QWidget *parent = nullptr)
parent 을 사용하여 모델의 데이터를 나타내는 컬럼 뷰를 생성합니다. 모델을 설정하려면 ` setModel()`를 사용하십시오.
QAbstractItemModel도 참조하십시오 .
[virtual noexcept] QColumnView::~QColumnView()
컬럼 보기를 제거합니다.
QList<int> QColumnView::columnWidths() const
이 뷰에 포함된 모든 열의 너비를 담은 목록을 반환합니다.
setColumnWidths()도 참조하십시오 .
[virtual protected] QAbstractItemView *QColumnView::createColumn(const QModelIndex &index)
항목을 선택할 때 마지막 열에 사용자 정의 위젯을 사용하려면 이 함수를 오버로드하고 위젯을 반환하십시오. ` index `는 뷰에 할당될 루트 인덱스입니다.
새로운 뷰를 반환하십시오. ` QColumnView `는 위젯에 대한 소유권을 자동으로 인수합니다.
setPreviewWidget()도 참조하십시오 .
[override virtual protected] void QColumnView::currentChanged(const QModelIndex ¤t, const QModelIndex &previous)
QAbstractItemView::currentChanged(const QModelIndex ¤t, const QModelIndex &previous)을 재구현합니다.
[override virtual protected] int QColumnView::horizontalOffset() const
QAbstractItemView::horizontalOffset() const를 재구현합니다.
[override virtual] QModelIndex QColumnView::indexAt(const QPoint &point) const
QAbstractItemView::indexAt(const QPoint &point) const를 재구현합니다.
[protected] void QColumnView::initializeColumn(QAbstractItemView *column) const
컬럼 뷰의 동작과 옵션을 복사하여 ` column `에 적용합니다. 예를 들어 ` iconSize()`, ` textElideMode()` 및 ` alternatingRowColors()`과 같은 메서드가 이에 해당합니다. 이는 ` createColumn()`을 재구현할 때 유용할 수 있습니다.
createColumn()도 참조하십시오 .
[override virtual protected] bool QColumnView::isIndexHidden(const QModelIndex &index) const
QAbstractItemView::isIndexHidden(const QModelIndex &index) const를 재구현합니다.
[override virtual protected] QModelIndex QColumnView::moveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers)
QAbstractItemView::moveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers)를 재구현합니다.
왼쪽 이동 시 상위 인덱스로 이동해야 하며, 오른쪽 이동 시 자식 인덱스로 이동해야 하고 자식이 없는 경우 아래로 이동해야 합니다.
QWidget *QColumnView::previewWidget() const
미리보기 위젯을 반환하거나, 없는 경우에는 ` nullptr `을 반환합니다.
setPreviewWidget() 및 updatePreviewWidget()도 참조하십시오 .
[override virtual protected] void QColumnView::resizeEvent(QResizeEvent *event)
QAbstractItemView::resizeEvent(QResizeEvent *event)를 재구현합니다.
[override virtual protected] void QColumnView::rowsInserted(const QModelIndex &parent, int start, int end)
QAbstractItemView::rowsInserted(const QModelIndex &parent, int start, int end)를 재구현합니다.
[override virtual protected] void QColumnView::scrollContentsBy(int dx, int dy)
QAbstractScrollArea::scrollContentsBy(int dx, int dy)를 재구현합니다.
[override virtual] void QColumnView::scrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint = EnsureVisible)
QAbstractItemView::scrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint)를 재구현합니다.
[override virtual] void QColumnView::selectAll()
QAbstractItemView::selectAll()을 재구현합니다.
void QColumnView::setColumnWidths(const QList<int> &list)
list 에 지정된 값으로 열 너비를 설정합니다. 목록에 포함된 추가 값들은 열이 생성될 때 그대로 유지되어 사용됩니다.
목록에 포함된 값이 너무 적을 경우, 나머지 열의 너비만 변경되지 않습니다.
columnWidths() 및 createColumn()도 참조하십시오 .
[override virtual] void QColumnView::setModel(QAbstractItemModel *model)
QAbstractItemView::setModel(QAbstractItemModel *model)을 재구현합니다.
void QColumnView::setPreviewWidget(QWidget *widget)
미리보기 widget 를 설정합니다.
widget 는 컬럼 뷰의 자식 요소가 되며, 컬럼 영역이 삭제되거나 새로운 위젯이 설정될 때 파기됩니다.
previewWidget() 및 updatePreviewWidget()도 참조하십시오 .
[override virtual] void QColumnView::setRootIndex(const QModelIndex &index)
QAbstractItemView::setRootIndex(const QModelIndex &index)를 재구현합니다.
[override virtual protected] void QColumnView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags command)
QAbstractItemView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags flags)를 재구현합니다.
[override virtual] void QColumnView::setSelectionModel(QItemSelectionModel *newSelectionModel)
QAbstractItemView::setSelectionModel(QItemSelectionModel *selectionModel)을 재구현합니다.
[override virtual] QSize QColumnView::sizeHint() const
QAbstractScrollArea::sizeHint() const를 재구현합니다.
[signal] void QColumnView::updatePreviewWidget(const QModelIndex &index)
이 신호는 미리보기 위젯을 업데이트하여 다음에 대한 상세한 정보를 제공해야 할 때 발생합니다. index
previewWidget()도 참조하십시오 .
[override virtual protected] int QColumnView::verticalOffset() const
QAbstractItemView::verticalOffset() const를 재구현합니다.
[override virtual] QRect QColumnView::visualRect(const QModelIndex &index) const
QAbstractItemView::visualRect(const QModelIndex &index) const를 재구현합니다.
[override virtual protected] QRegion QColumnView::visualRegionForSelection(const QItemSelection &selection) const
QAbstractItemView::visualRegionForSelection(const QItemSelection &selection) const를 재구현합니다.
© 2026 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.