QTreeView Class

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

メンバー関数のドキュメント

[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 のサイズが変更されるたびに呼び出されます。oldSize およびnewSize は、それぞれ以前のサイズと新しいサイズをピクセル単位で返します。

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

指定された「region 」と交差するツリーの一部を、指定された「painter 」を使用して描画します。

paintEvent()も参照してください 。

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

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

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

[slot] void QTreeView::expandAll()

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

関連項目： collapseAll()、expand()、collapse()、およびsetExpanded()。

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

指定されたindex にある項目とそのすべての子要素を、指定されたdepth まで展開します。depth は、指定されたindex を基準としています。depth を-1に設定するとすべての子要素が展開され、depth を0に設定すると、指定されたindex のみが展開されます。

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

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

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

関連項目： expandAll()、collapseAll()、expand()、collapse()、およびsetExpanded()。

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

このシグナルは、index で指定された項目が展開されたときに発生します。

setExpanded()も参照してください 。

QHeaderView *QTreeView::header() const

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

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

[slot] void QTreeView::hideColumn(int 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

指定されたrow のparent の最初の列にある項目が、すべての列にまたがっている場合は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()も参照してください 。

[since 6.12] QRect QTreeView::itemDecorationRect(const QModelIndex &index) const

index にある項目の展開／折りたたみインジケータが占める矩形を返します。例えば、子要素がない場合やルート装飾が無効になっている場合など、その項目にそのようなインジケータがない場合、返される矩形は無効となります。無効な `index ` も、無効な矩形を返します。

この関数は Qt 6.12 で導入されました。

visualRect() およびQStyle::SE_TreeViewDisclosureItemも参照してください 。

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

指定されたparent モデル項目から、start 行からend 行まで（これら2行を含む）の行が削除されたことをビューに通知します。

[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 が true の場合、column は非表示になり、そうでない場合はcolumn が表示されます。

isColumnHidden()、hideColumn()、およびsetRowHidden()も参照してください 。

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

指定されたcolumn の幅を、指定されたwidth に設定します。

columnWidth() およびresizeColumnToContents()も参照してください 。

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

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

expanded()、expand()、およびisExpanded()も参照してください 。

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

span が true の場合、row の 1 列目にあり、指定されたparent を持つ項目は、すべての列にまたがるように設定されます。それ以外の場合は、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 がtrueの場合、指定された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::sizeHint 、header()、およびQHeaderView::resizeContentsPrecision()も参照してください 。

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

指定されたcolumn およびorder の値に基づいてモデルをソートします。

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

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 の時点で、そのアイテムがビューポート上で占める矩形を返します。インデックスが非表示であるか、明示的に非表示にされている場合、返される矩形は無効となります。

itemDecorationRect()も参照してください 。

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

QAbstractItemView::visualRegionForSelection(const QItemSelection &selection) const を再実装します。

指定された `selection` 内の項目のビューポートから矩形を返します。

バージョン 4.7 以降、返される領域には、ビューポートと交差する（またはビューポートに含まれる）矩形のみが含まれます。