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 は、ツリー内の各階層ごとに 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 ¤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.