このページでは

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 は、ツリー内の各階層ごとに 1 つずつ、複数の QListView を使用してモデルを表示します。これは、カスケードリストと呼ばれることもあります。

QColumnView クラスは、モデル/ビュークラスの一つであり、Qtのモデル/ビューフレームワークの一部です。

QColumnViewは、QAbstractItemView クラスによって定義されたインターフェースを実装しており、QAbstractItemModel クラスを継承したモデルから提供されるデータを表示できるようにしています。

列ビューのアドレス情報

「Model/Viewプログラミング」も参照してください 。

プロパティのドキュメント

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