QTreeView Class

QTreeViewクラスは、ツリービューのデフォルトのモデル/ビュー実装を提供します。詳細...

ヘッダー #include <QTreeView>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
を継承する: QAbstractItemView
によって継承される:

QHelpContentWidget そしてQTreeWidget

プロパティ

パブリック関数

QTreeView(QWidget *parent = nullptr)
virtual ~QTreeView()
bool allColumnsShowFocus() const
int autoExpandDelay() const
int columnAt(int x) const
int columnViewportPosition(int column) const
int columnWidth(int column) const
bool expandsOnDoubleClick() const
QHeaderView *header() const
int indentation() const
QModelIndex indexAbove(const QModelIndex &index) const
QModelIndex indexBelow(const QModelIndex &index) const
bool isAnimated() const
bool isColumnHidden(int column) const
bool isExpanded(const QModelIndex &index) const
bool isFirstColumnSpanned(int row, const QModelIndex &parent) const
bool isHeaderHidden() const
bool isRowHidden(int row, const QModelIndex &parent) const
bool isSortingEnabled() const
bool itemsExpandable() const
void resetIndentation()
bool rootIsDecorated() const
void setAllColumnsShowFocus(bool enable)
void setAnimated(bool enable)
void setAutoExpandDelay(int delay)
void setColumnHidden(int column, bool hide)
void setColumnWidth(int column, int width)
void setExpanded(const QModelIndex &index, bool expanded)
void setExpandsOnDoubleClick(bool enable)
void setFirstColumnSpanned(int row, const QModelIndex &parent, bool span)
void setHeader(QHeaderView *header)
void setHeaderHidden(bool hide)
void setIndentation(int i)
void setItemsExpandable(bool enable)
void setRootIsDecorated(bool show)
void setRowHidden(int row, const QModelIndex &parent, bool hide)
void setSortingEnabled(bool enable)
void setTreePosition(int index)
void setUniformRowHeights(bool uniform)
void setWordWrap(bool on)
int treePosition() const
bool uniformRowHeights() const
bool wordWrap() const

再実装パブリック関数

virtual void dataChanged(const QModelIndex &topLeft, const QModelIndex &bottomRight, const QList<int> &roles = QList<int>()) override
virtual QModelIndex indexAt(const QPoint &point) const override
virtual void keyboardSearch(const QString &search) override
virtual void reset() 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 *selectionModel) override
virtual QRect visualRect(const QModelIndex &index) const override

パブリック・スロット

void collapse(const QModelIndex &index)
void collapseAll()
void expand(const QModelIndex &index)
void expandAll()
void expandRecursively(const QModelIndex &index, int depth = -1)
void expandToDepth(int depth)
void hideColumn(int column)
void resizeColumnToContents(int column)
void showColumn(int column)
void sortByColumn(int column, Qt::SortOrder order)

シグナル

void collapsed(const QModelIndex &index)
void expanded(const QModelIndex &index)

保護された関数

virtual void drawBranches(QPainter *painter, const QRect &rect, const QModelIndex &index) const
virtual void drawRow(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const
void drawTree(QPainter *painter, const QRegion &region) const
int indexRowSizeHint(const QModelIndex &index) const
int rowHeight(const QModelIndex &index) const

再実装された保護された関数

virtual void changeEvent(QEvent *event) override
virtual void currentChanged(const QModelIndex &current, const QModelIndex &previous) override
virtual void dragMoveEvent(QDragMoveEvent *event) override
virtual int horizontalOffset() const override
virtual bool isIndexHidden(const QModelIndex &index) const override
virtual void keyPressEvent(QKeyEvent *event) override
virtual void mouseDoubleClickEvent(QMouseEvent *event) override
virtual void mouseMoveEvent(QMouseEvent *event) override
virtual void mousePressEvent(QMouseEvent *event) override
virtual void mouseReleaseEvent(QMouseEvent *event) override
virtual QModelIndex moveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers) override
virtual void paintEvent(QPaintEvent *event) override
virtual void rowsAboutToBeRemoved(const QModelIndex &parent, int start, int end) override
virtual void rowsInserted(const QModelIndex &parent, int start, int end) override
virtual void scrollContentsBy(int dx, int dy) override
virtual QModelIndexList selectedIndexes() const override
virtual void selectionChanged(const QItemSelection &selected, const QItemSelection &deselected) override
virtual void setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags command) override
virtual int sizeHintForColumn(int column) const override
virtual void timerEvent(QTimerEvent *event) override
virtual void updateGeometries() override
virtual int verticalOffset() const override
virtual bool viewportEvent(QEvent *event) override
virtual QSize viewportSizeHint() const override
virtual QRegion visualRegionForSelection(const QItemSelection &selection) const override

保護されたスロット

void columnCountChanged(int oldCount, int newCount)
void columnMoved()
void columnResized(int column, int oldSize, int newSize)
void rowsRemoved(const QModelIndex &parent, int start, int end)

詳細説明

QTreeViewは、モデルからのアイテムのツリー表現を実装します。このクラスは、以前はQListView クラスによって提供されていた標準的な階層リストを、Qt のモデル/ビュー・アーキテクチャーによって提供されるより柔軟なアプローチを使用して提供するために使用されます。

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

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

モデルからのデータを表示するツリー・ビューを構築するのは簡単です。以下の例では、QFileSystemModel からディレクトリの内容が提供され、ツリーとして表示されています:

    QFileSystemModel *model = new QFileSystemModel;
    model->setRootPath(QDir::currentPath());
    QTreeView *tree = new QTreeView(splitter);
    tree->setModel(model);

モデル/ビュー・アーキテクチャは、モデルが変更されるとツリー・ビューの内容が更新されることを保証します。

子を持つアイテムは、展開状態(子が見える状態)または折りたたみ状態(子が隠された状態)にすることができます。この状態が変更されると、collapsed() またはexpanded() シグナルが、関連するアイテムのモデルインデックスと共に発行されます。

階層のレベルを示すために使用されるインデントの量は、indentation プロパティによって制御されます。

ツリー・ビューのヘッダーは、QHeaderView クラスを使用して構築され、header()->hide() を使用して非表示にすることができます。各ヘッダーは、stretchLastSection プロパティがtrueに設定され、ビューがそのヘッダーのために割り当てられたスペースを無駄にしないように構成されていることに注意してください。この値がtrueに設定されている場合、このプロパティはヘッダーの最後のセクションに設定されているリサイズモードを上書きします。

デフォルトでは、ツリービューのすべての列は、最初の列を除いて移動可能です。これらの列の移動を無効にするには、QHeaderViewsetSectionsMovable() 関数を使用します。セクションの並べ替えの詳細については、Moving Header Sections を参照してください。

キーバインド

QTreeViewは、ユーザーがビューをナビゲートし、アイテムのコンテンツを操作できるようにする、一連のキー・バインディングをサポートしています:

キーアクション
カーソルを前の行の同じ列のアイテムに移動する。現在のアイテムの親に移動できる行がない場合、カーソルは親の前にある兄弟の最後の行の関連するアイテムに移動します。
カーソルを次の行の同じ列の項目に移動する。現在の項目の親に移動する行がない場合、カーソルは親に続く兄弟の最初の行の関連する項目に移動する。
分岐を折りたたむことで、現在の項目の子(存在する場合)を隠す。
マイナスLeft と同じ。
分岐を広げて、現在のアイテムの子(存在する場合)を表示します。
プラスRight と同じ。
アスタリスク現在のアイテムとそのすべての子アイテム(存在する場合)を展開します。
ページアップカーソルを1ページ上に移動する。
PageDownカーソルを1ページ下に移動する。
ホームカーソルをモデルの最上位項目の最初の行の同じ列にある項目に移動する。
Endカーソルをモデル内の最後のトップレベル項目の最後の行の同じ列にある項目に移動する。
F2編集可能なモデルでは、編集のために現在の項目を開きます。Escapeキーを使用すると、編集プロセスをキャンセルし、表示されているデータの変更を元に戻すことができます。

パフォーマンスの向上

多数のアイテムを表示する際のパフォーマンスを向上させるために、ビューが扱うデータに関するヒントを与えることが可能です。等しい高さのアイテムを表示することを意図しているビューのために取ることができる1つのアプローチは、uniformRowHeights プロパティをtrueに設定することです。

QListView,QTreeWidget,ビュークラス,QAbstractItemModel,QAbstractItemViewも参照してください

プロパティ・ドキュメンテーション

allColumnsShowFocus : bool

このプロパティは、アイテムがすべての列を使用してキーボードフォーカスを表示するかどうかを保持します。

このプロパティがtrue の場合、すべての列がフォーカスを表示し、そうでない場合は1つの列のみがフォーカスを表示します。

デフォルトはfalseです。

アクセス関数:

bool allColumnsShowFocus() const
void setAllColumnsShowFocus(bool enable)

animated : bool

このプロパティは、アニメーションを有効にするかどうかを保持します。

このプロパティがtrue の場合、ツリービューは枝の展開と折りたたみをアニメートします。このプロパティがfalse である場合、ツリービューはアニメーションを表示せずに、枝を即座に展開または折りたたみます。

デフォルトでは、このプロパティはfalse です。

アクセス関数:

bool isAnimated() const
void setAnimated(bool enable)

autoExpandDelay : int

このプロパティは、ドラッグ&ドロップ操作中にツリー内のアイテムが開かれるまでの遅延時間を保持します。

このプロパティは、ノードが自動的に開くまでに、ユーザがノードの上で待たなければならない時間をミリ秒単位で保持します。この時間が 0 未満に設定されている場合、そのノードはアクティブになりません。

デフォルトでは、このプロパティの値は-1であり、自動拡張が無効であることを意味する。

アクセス関数:

int autoExpandDelay() const
void setAutoExpandDelay(int delay)

expandsOnDoubleClick : bool

このプロパティは、ダブルクリックによる項目の展開の可否を保持する。

このプロパティは、ユーザがダブルクリックによって項目を展開または折りたたむことができるかどうかを保持する。デフォルト値はtrueである。

アクセス関数:

bool expandsOnDoubleClick() const
void setExpandsOnDoubleClick(bool enable)

itemsExpandableも参照してください

headerHidden : bool

このプロパティは、ヘッダーを表示するかどうかを保持する。

このプロパティがtrue の場合、ヘッダは表示されない。デフォルト値はfalseです。

アクセス関数:

bool isHeaderHidden() const
void setHeaderHidden(bool hide)

header()も参照のこと

indentation : int

ツリービューのアイテムのインデント。

このプロパティは、ツリービューの各レベルのアイテムのピクセル単位で測定されたインデントを保持する。トップレベルのアイテムの場合、インデントはビューポートの端から最初の列のアイテムまでの水平距離を指定し、子アイテムの場合、親アイテムからのインデントを指定する。

デフォルトでは、このプロパティの値はスタイルに依存する。したがって、スタイルが変更されると、このプロパティも変更されます。setIndentation()を呼び出すと更新が停止し、resetIndentation()を呼び出すとデフォルトの動作に戻ります。

アクセス関数:

int indentation() const
void setIndentation(int i)
void resetIndentation()

itemsExpandable : bool

このプロパティは、項目がユーザによって展開可能かどうかを保持する。

このプロパティは、ユーザが対話的に項目を展開および折りたたむことができるかどうかを保持する。

デフォルトでは、このプロパティはtrue です。

アクセス関数:

bool itemsExpandable() const
void setItemsExpandable(bool enable)

rootIsDecorated : bool

このプロパティは、最上位アイテムを展開および折りたたむためのコントロールを表示するかどうかを保持する。

子アイテムを持つアイテムは通常、それらを展開および折りたたむためのコントロールと共に表示され、子アイテムを表示または非表示にすることができる。このプロパティがfalseの場合、トップレベル項目にはこれらのコントロールは表示されない。これを使用すると、単一レベルのツリー構造を単純な項目のリストのように見せることができる。

デフォルトでは、このプロパティはtrue です。

アクセス関数:

bool rootIsDecorated() const
void setRootIsDecorated(bool show)

sortingEnabled : bool

このプロパティは、ソートが有効かどうかを保持する。

このプロパティがtrue の場合、ツリーでソートが有効になります。このプロパティが false の場合、ソートは有効になりません。デフォルト値は false です。

注釈 パフォーマンスの問題を回避するには、ツリーに項目を挿入した後で並べ替えを有効にすることをお勧めします。また、ツリーに項目を挿入する前に、項目をリストに挿入することもできます。

アクセス関数:

bool isSortingEnabled() const
void setSortingEnabled(bool enable)

sortByColumn()も参照してください

uniformRowHeights : bool

このプロパティは、ツリービュー内のすべてのアイテムが同じ高さを持つかどうかを保持します。

このプロパティは、ビュー内のすべてのアイテムの高さが同じであることが保証されている場合にのみ、true に設定する必要があります。これにより、ビューはいくつかの最適化を行うことができる。

高さはビューの最初の項目から取得されます。そのアイテムのデータが変更されると更新されます。

注意: エディタサイズヒントがセルサイズヒントより大きい場合、エディタのサイズヒントが使用されます。

デフォルトでは、このプロパティはfalse です。

アクセス関数:

bool uniformRowHeights() const
void setUniformRowHeights(bool uniform)

wordWrap : bool

このプロパティは、項目テキストの単語折り返しポリシーを保持する。

このプロパティがtrue の場合、アイテムのテキストは必要に応じて単語区切りで折り返されます。このプロパティはデフォルトではfalse である。

折り返しが有効になっていても、すべてのテキストに合わせてセルが拡大されるわけではないことに注意してください。省略記号はカ レ ン トtextElideMode に従っ て挿入 さ れます。

アクセス関数:

bool wordWrap() const
void setWordWrap(bool on)

メンバ関数ドキュメント

[explicit] QTreeView::QTreeView(QWidget *parent = nullptr)

parent 、モデルのデータを表すツリー・ビューを構築します。モデルを設定するにはsetModel() を使用します。

QAbstractItemModelも参照してください

[virtual noexcept] QTreeView::~QTreeView()

ツリービューを破壊する。

[override virtual protected] void QTreeView::changeEvent(QEvent *event)

再インプリメント:QFrame::changeEvent(QEvent *ev).

[slot] void QTreeView::collapse(const QModelIndex &index)

index で指定されたモデル項目を折りたたみます。

collapsed()も参照

[slot] void QTreeView::collapseAll()

展開された項目をすべて折りたたむ。

expandAll()、expand()、collapse() およびsetExpanded()も参照

[signal] void QTreeView::collapsed(const QModelIndex &index)

このシグナルは、index で指定されたアイテムが折りたたまれたときに発せられる。

int QTreeView::columnAt(int x) const

指定されたx 座標をヘッダーに持つツリービューの列を返します。

[protected slot] void QTreeView::columnCountChanged(int oldCount, int newCount)

ツリービューの列数がoldCount からnewCount に変更されたことをツリービューに通知します。

[protected slot] void QTreeView::columnMoved()

このスロットは、カラムが移動するたびに呼び出される。

[protected slot] void QTreeView::columnResized(int column, int oldSize, int newSize)

この関数は、ヘッダー内でcolumn のサイズが変更されるたびに呼び出される。oldSizenewSize は、以前のサイズと新しいサイズをピクセル単位で示す。

setColumnWidth()も参照のこと

int QTreeView::columnViewportPosition(int column) const

ビューポート内のcolumn の水平位置を返す。

int QTreeView::columnWidth(int column) const

column の幅を返す。

resizeColumnToContents() およびsetColumnWidth()も参照

[override virtual protected] void QTreeView::currentChanged(const QModelIndex &current, const QModelIndex &previous)

再実装:QAbstractItemView::currentChanged(const QModelIndex &current, const QModelIndex &previous)。

[override virtual] void QTreeView::dataChanged(const QModelIndex &topLeft, const QModelIndex &bottomRight, const QList<int> &roles = QList<int>())

再実装:QAbstractItemView::dataChanged(const QModelIndex &topLeft, const QModelIndex &bottomRight, const QList<int> &roles)。

[override virtual protected] void QTreeView::dragMoveEvent(QDragMoveEvent *event)

再実装:QAbstractItemView::dragMoveEvent(QDragMoveEvent *event)。

[virtual protected] void QTreeView::drawBranches(QPainter *painter, const QRect &rect, const QModelIndex &index) const

指定されたpainter を使って、モデル項目index と同じ行のツリービューに枝を描画します。枝はrect で指定された矩形内に描画されます。

[virtual protected] void QTreeView::drawRow(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const

指定されたpainter を使用して、モデル項目index を含むツリービューの行を描画します。option は、アイテムの表示方法を制御します。

setAlternatingRowColors()も参照してください

[protected] void QTreeView::drawTree(QPainter *painter, const QRegion &region) const

指定されたpainter を用いて、指定されたregion と交差する木の部分を描画します。

paintEvent()も参照

[slot] void QTreeView::expand(const QModelIndex &index)

index で指定されたモデル項目を展開する。

expanded()も参照してください

[slot] void QTreeView::expandAll()

すべての展開可能な項目を展開します。

注意: この関数は、fetch more データを試行しません。

警告 モデルに多数の項目が含まれる場合、この関数の実行には時間がかかります。

collapseAll(),expand(),collapse(),setExpanded()も参照してください

[slot] void QTreeView::expandRecursively(const QModelIndex &index, int depth = -1)

与えられたindex の項目とそのすべての子を、与えられたdepth に展開する。depth は、与えられたindex からの相対値です。depth に -1 を指定するとすべての子を展開し、depth に 0 を指定すると指定されたindex のみを展開します。

注意 : この関数はfetch more データを展開しようとしません。

警告: モデルに多数の項目が含まれている場合、この関数の実行には時間がかかります。

expandAll()も参照してください

[slot] void QTreeView::expandToDepth(int depth)

すべての展開可能な項目を、指定されたdepth に展開します。

注意: この関数はfetch more データを試行しません。

expandAll()、collapseAll()、expand()、collapse() およびsetExpanded()も参照

[signal] void QTreeView::expanded(const QModelIndex &index)

このシグナルは、index で指定された項目が展開されたときに発せられる。

setExpanded()も参照のこと

ツリー・ビューのヘッダーを返します。

setHeader() およびQAbstractItemModel::headerData()も参照 ください。

[slot] void QTreeView::hideColumn(int column)

与えられたcolumn を非表示にする。

注: この関数はモデルが初期化された後にのみ呼び出されるべきです。ビューはcolumn を隠すために列の数を知る必要があるからです。

showColumn() およびsetColumnHidden()も参照して ください。

[override virtual protected] int QTreeView::horizontalOffset() const

再実装:QAbstractItemView::horizontalOffset() const.

ツリービュー内のアイテムの水平オフセットを返します。

ツリービューでは、ビュー内のカラムの位置を決定するために水平方向のヘッダセクションの位置を使用することに注意してください。

verticalOffset()も参照してください

QModelIndex QTreeView::indexAbove(const QModelIndex &index) const

index より上の項目のモデルインデックスを返します。

[override virtual] QModelIndex QTreeView::indexAt(const QPoint &point) const

再実装:QAbstractItemView::indexAt(const QPoint &point) const.

QModelIndex QTreeView::indexBelow(const QModelIndex &index) const

index 以下の項目のモデルインデックスを返します。

[protected] int QTreeView::indexRowSizeHint(const QModelIndex &index) const

index で示される行のサイズヒントを返す。

sizeHintForColumn() およびuniformRowHeights()も参照

bool QTreeView::isColumnHidden(int column) const

column が非表示の場合はtrue を返し、そうでない場合はfalse を返す。

hideColumn() およびisRowHidden()も参照のこと

bool QTreeView::isExpanded(const QModelIndex &index) const

モデル項目index が展開されていればtrue を返し、そうでなければ false を返す。

expand(),expanded(),setExpanded()も参照

bool QTreeView::isFirstColumnSpanned(int row, const QModelIndex &parent) const

parent の与えられたrow の最初のカラムの項目がすべてのカラムにまたがっている場合はtrue を返し、そうでない場合はfalse を返す。

setFirstColumnSpanned()も参照のこと

[override virtual protected] bool QTreeView::isIndexHidden(const QModelIndex &index) const

再実装:QAbstractItemView::isIndexHidden(const QModelIndex &index) const.

bool QTreeView::isRowHidden(int row, const QModelIndex &parent) const

parent の指定されたrow の項目が非表示の場合はtrue を返し、そうでない場合はfalse を返す。

setRowHidden() およびisColumnHidden()も参照

[override virtual protected] void QTreeView::keyPressEvent(QKeyEvent *event)

再実装:QAbstractItemView::keyPressEvent(QKeyEvent *event)。

[override virtual] void QTreeView::keyboardSearch(const QString &search)

再実装:QAbstractItemView::keyboardSearch(const QString &search).

[override virtual protected] void QTreeView::mouseDoubleClickEvent(QMouseEvent *event)

再実装:QAbstractItemView::mouseDoubleClickEvent(QMouseEvent *event)。

[override virtual protected] void QTreeView::mouseMoveEvent(QMouseEvent *event)

再実装:QAbstractItemView::mouseMoveEvent(QMouseEvent *event)。

[override virtual protected] void QTreeView::mousePressEvent(QMouseEvent *event)

再実装:QAbstractItemView::mousePressEvent(QMouseEvent *event)。

[override virtual protected] void QTreeView::mouseReleaseEvent(QMouseEvent *event)

再実装:QAbstractItemView::mouseReleaseEvent(QMouseEvent *event)。

[override virtual protected] QModelIndex QTreeView::moveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers)

再実装:QAbstractItemView::moveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers)。

ボタンmodifiers によって提供される情報を使用して、cursorAction によって記述される方法でカーソルを移動します。

[override virtual protected] void QTreeView::paintEvent(QPaintEvent *event)

再実装:QAbstractScrollArea::paintEvent(QPaintEvent *event)。

[override virtual] void QTreeView::reset()

再インプリメント:QAbstractItemView::reset().

[slot] void QTreeView::resizeColumnToContents(int column)

指定されたcolumn のサイズをその内容のサイズに変更する。

columnWidth()、setColumnWidth()、sizeHintForColumn() およびQHeaderView::resizeContentsPrecision()も参照

[protected] int QTreeView::rowHeight(const QModelIndex &index) const

与えられたindex で示される行の高さを返します。

indexRowSizeHint()も参照

[override virtual protected] void QTreeView::rowsAboutToBeRemoved(const QModelIndex &parent, int start, int end)

再実装:QAbstractItemView::rowsAboutToBeRemoved(const QModelIndex &parent, int start, int end)。

start 行からend 行までを含む行が、与えられたparent モデルアイテムから削除されようとしていることをビューに通知します。

[override virtual protected] void QTreeView::rowsInserted(const QModelIndex &parent, int start, int end)

再実装:QAbstractItemView::rowsInserted(const QModelIndex &parent, int start, int end)。

start 行からend 行までを含む行がparent モデルアイテムに挿入されたことをビューに通知します。

[protected slot] void QTreeView::rowsRemoved(const QModelIndex &parent, int start, int end)

start 行からend 行までを含む行が、指定されたparent モデルアイテムから削除されたことをビューに通知します。

[override virtual protected] void QTreeView::scrollContentsBy(int dx, int dy)

再実装:QAbstractScrollArea::scrollContentsBy(int dx, int dy).

ツリービューの内容を (dx,dy) だけスクロールします。

[override virtual] void QTreeView::scrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint = EnsureVisible)

再実装:QAbstractItemView::scrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint)。

与えられたモデルアイテムindex が表示されるまで、ツリービューの内容をスクロールします。hint パラメータは、操作後にアイテムがどこに位置するかをより正確に指定します。モデルアイテムの親のいずれかが折りたたまれている場合、それらはモデルアイテムが見えるように拡張されます。

[override virtual] void QTreeView::selectAll()

再インプリメント:QAbstractItemView::selectAll().

[override virtual protected] QModelIndexList QTreeView::selectedIndexes() const

再実装:QAbstractItemView::selectedIndexes() const.

[override virtual protected] void QTreeView::selectionChanged(const QItemSelection &selected, const QItemSelection &deselected)

再実装:QAbstractItemView::selectionChanged(const QItemSelection &selected, const QItemSelection &deselected).

void QTreeView::setColumnHidden(int column, bool hide)

hide が真の場合、column は隠され、そうでない場合はcolumn が表示される。

isColumnHidden()、hideColumn()、setRowHidden()も参照のこと

void QTreeView::setColumnWidth(int column, int width)

与えられたcolumn の幅を、指定されたwidth に設定する。

columnWidth() およびresizeColumnToContents()も参照

void QTreeView::setExpanded(const QModelIndex &index, bool expanded)

expanded の値に応じて、index が参照する項目を折りたたみまたは展開のいずれかに設定する。

expanded()、expand()、isExpanded()も参照

void QTreeView::setFirstColumnSpanned(int row, const QModelIndex &parent, bool span)

span が true の場合、与えられたparent を持つrow の最初のカラムの項目がすべてのカラムにまたがるように設定され、そうでない場合はrow のすべての項目が表示される。

isFirstColumnSpanned()も参照

void QTreeView::setHeader(QHeaderView *header)

ツリービューのヘッダーを、与えられたheader に設定します。

ビューは与えられたheader の所有権を持ち、新しいヘッダが設定されるとそれを削除します。

QAbstractItemModel::headerData()も参照してください

[override virtual] void QTreeView::setModel(QAbstractItemModel *model)

再実装:QAbstractItemView::setModel(QAbstractItemModel *model).

[override virtual] void QTreeView::setRootIndex(const QModelIndex &index)

再実装:QAbstractItemView::setRootIndex(const QModelIndex &index)。

void QTreeView::setRowHidden(int row, const QModelIndex &parent, bool hide)

hide が真の場合、与えられたparent を持つrow は隠され、そうでない場合はrow が表示される。

isRowHidden() およびsetColumnHidden()も参照

[override virtual protected] void QTreeView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags command)

再実装:QAbstractItemView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags flags)。

選択command を、矩形内または矩形によってタッチされたアイテムに適用します,rect

selectionCommand()も参照してください

[override virtual] void QTreeView::setSelectionModel(QItemSelectionModel *selectionModel)

再実装:QAbstractItemView::setSelectionModel(QItemSelectionModel *selectionModel)。

void QTreeView::setTreePosition(int index)

これは、ツリー構造を論理インデックスindex に配置することを指定する。 を -1 に設定すると、ツリーは常に視覚インデックス 0 に従う。

treePosition(),QHeaderView::swapSections(),QHeaderView::moveSection()も参照

[slot] void QTreeView::showColumn(int column)

指定されたcolumn をツリービューに表示する。

hideColumn() およびsetColumnHidden()も参照

[override virtual protected] int QTreeView::sizeHintForColumn(int column) const

再インプリメント:QAbstractItemView::sizeHintForColumn(int column) const.

column の幅のサイズヒントを返すか、モデルがない場合は -1 を返します。

指定したカラムの幅を固定値に設定する必要がある場合は、 ビューのヘッダでQHeaderView::resizeSection() をコールします。

この関数をサブクラスで再実装する場合、返す値はresizeColumnToContents() が呼び出されたときにのみ使用されることに注意してください。その場合、ビューのヘッダまたはアイテムのデリゲートでより大きな列幅が必要な場合は、その幅が代わりに使用されます。

QWidget::sizeHintheader()、QHeaderView::resizeContentsPrecision()も参照してください

[slot] void QTreeView::sortByColumn(int column, Qt::SortOrder order)

与えられたcolumnorder の値でモデルをソートします。

column この場合、ソートインジケータは表示されず、モデルはソートされていない自然な順序に戻ります。すべてのモデルがこれをサポートしているわけではなく、この場合クラッシュする可能性があることに注意してください。

sortingEnabledも参照して ください。

[override virtual protected] void QTreeView::timerEvent(QTimerEvent *event)

再実装:QAbstractItemView::timerEvent(QTimerEvent *event).

int QTreeView::treePosition() const

ツリーが設定されている論理インデックスを返す。戻り値が -1 の場合、ツリーは視覚インデックス 0 に置かれます。

setTreePosition()も参照

[override virtual protected] void QTreeView::updateGeometries()

再インプリメント:QAbstractItemView::updateGeometries().

[override virtual protected] int QTreeView::verticalOffset() const

再実装:QAbstractItemView::verticalOffset() const.

ツリービューのアイテムの垂直オフセットを返します。

horizontalOffset()も参照ください

[override virtual protected] bool QTreeView::viewportEvent(QEvent *event)

再実装:QAbstractItemView::viewportEvent(QEvent *event)。

[override virtual protected] QSize QTreeView::viewportSizeHint() const

再実装:QAbstractItemView::viewportSizeHint() const.

[override virtual] QRect QTreeView::visualRect(const QModelIndex &index) const

再実装:QAbstractItemView::visualRect(const QModelIndex &index) const.

index のアイテムが占めるビューポート上の矩形を返します。インデックスが表示されていないか、明示的に非表示になっている場合、返される矩形は無効です。

[override virtual protected] QRegion QTreeView::visualRegionForSelection(const QItemSelection &selection) const

再実装:QAbstractItemView::visualRegionForSelection(const QItemSelection &selection) const.

与えられたselection 内のアイテムのビューポートからの矩形を返します。

4.7以降、返される領域は、ビューポートと交差する(またはビューポートに含まれる)矩形のみを含みます。

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