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: |
プロパティ
|
|
パブリック関数
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,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 ¤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>())
再実装: (const QModelIndex ¤t, 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 ®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)
再リンプルメント: (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::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
再リンプルメント: (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.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。