QColumnView Class

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

Header: #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
QWidget *previewWidget() const
bool resizeGripsVisible() const
void setColumnWidths(const QList<int> &list)
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에 모델을 표시합니다. 이를 계단식 목록이라고도 합니다.

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

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

모델/뷰 프로그래밍도참조하십시오 .

속성 문서

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

열 보기의 동작 및 옵션을 복사하여 iconSize(), textElideMode() 및 alternatingRowColors()와 같은 column 에 적용합니다. 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::커서 액션 커서 액션, Qt::키보드 모디파이어 수정자).

왼쪽으로 이동하면 부모 색인으로 이동 오른쪽으로 이동하면 자식 색인으로 이동하거나 자식이 없으면 아래로 이동합니다.

QWidget *QColumnView::previewWidget() const

미리보기 위젯을 반환하거나 위젯이 없으면 nullptr 을 반환합니다.

setPreviewWidget() 및 updatePreviewWidget()도 참조하세요 .

[override virtual protected] void QColumnView::resizeEvent(QResizeEvent *event)

다시 구현합니다: QAbstractItemView::resizeEvent(QResizeEvent * 이벤트).

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

[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 플래그).

[override virtual] void QColumnView::setSelectionModel(QItemSelectionModel *newSelectionModel)

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

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

© 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.