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

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

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

モデル/ビュー・プログラミング」も参照してください

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

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

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