이 페이지에서

QColumnView Class

QColumnView 클래스는 컬럼 뷰의 모델/뷰 구현을 제공합니다. 더 보기...

헤더: #include <QColumnView>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
상속: QAbstractItemView

속성

공개 함수

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 &current, 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 &current, const QModelIndex &previous)

QAbstractItemView::currentChanged(const QModelIndex &current, 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.