QTreeView Class

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

Header: #include <QTreeView>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Inherits: QAbstractItemView
Inherited By:

QHelpContentWidget and 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,View Classes,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 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>())

再実装: (const QModelIndex &current, const QModelIndex &previous):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)

再リンプルメント: (QKeyEvent *event):QAbstractItemView::keyboardSearch(const QString &search)。

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

再リンプルメント: (const QString &search):QAbstractItemView::mouseDoubleClickEvent(QMouseEvent *event)。

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

再リンプルメント: (QMouseEvent *event):QAbstractItemView::mouseMoveEvent(QMouseEvent *event)。

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

再リンプルメント: (QMouseEvent *event)QAbstractItemView::mousePressEvent(QMouseEvent *event).

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

再リンプルメント: (QMouseEvent *event)QAbstractItemView::mouseReleaseEvent(QMouseEvent *event).

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

再リンプルメント: (QMouseEvent *event)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()

Reimplements: (QPaintEvent *event):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 が参照する項目を collapse または expanded に設定する。

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

再リンプルメント: (QEvent *event):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 以降、返される領域は、ビューポートと交差する(またはビューポートに含まれる)矩形のみを含みます。

©2024 The Qt Company Ltd. 本文書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。