QTreeView Class
QTreeViewクラスは、ツリービューのデフォルトのモデル/ビュー実装を提供します。詳細...
ヘッダー | #include <QTreeView> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
qmake: | QT += widgets |
を継承する: | QAbstractItemView |
によって継承される: |
プロパティ
|
|
パブリック関数
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) |
シグナル
保護された関数
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 ®ion) const |
int | indexRowSizeHint(const QModelIndex &index) const |
int | rowHeight(const QModelIndex &index) const |
再実装された保護された関数
virtual void | changeEvent(QEvent *event) override |
virtual void | currentChanged(const QModelIndex ¤t, 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に設定されている場合、このプロパティはヘッダーの最後のセクションに設定されているリサイズモードを上書きします。
デフォルトでは、ツリービューのすべての列は、最初の列を除いて移動可能です。これらの列の移動を無効にするには、QHeaderView のsetSectionsMovable() 関数を使用します。セクションの並べ替えの詳細については、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 のサイズが変更されるたびに呼び出される。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 ¤t, const QModelIndex &previous)
再実装:QAbstractItemView::currentChanged(const QModelIndex ¤t, 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 ®ion) 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()も参照のこと 。
QHeaderView *QTreeView::header() const
ツリー・ビューのヘッダーを返します。
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::sizeHint 、header()、QHeaderView::resizeContentsPrecision()も参照してください 。
[slot]
void QTreeView::sortByColumn(int column, Qt::SortOrder order)
与えられたcolumn とorder の値でモデルをソートします。
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.