QTreeView Class

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

Documentation sur les fonctions membres

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

Crée une arborescence à l'aide d'un objet ` parent ` pour représenter les données d'un modèle. Utilisez la méthode ` setModel()` pour définir le modèle.

Voir également QAbstractItemModel.

[virtual noexcept] QTreeView::~QTreeView()

Supprime l'arborescence.

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

Réimplémente : QFrame::changeEvent(QEvent *ev).

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

Réduit l'élément du modèle spécifié par l'index.

Voir aussi collapsed().

[slot] void QTreeView::collapseAll()

Réduit tous les éléments développés.

Voir également expandAll(), expand(), collapse() et setExpanded().

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

Ce signal est émis lorsque l'élément spécifié par « index » est masqué.

int QTreeView::columnAt(int x) const

Renvoie la colonne de l'arborescence dont l'en-tête recouvre la coordonnée x indiquée.

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

Indique à l'arborescence que le nombre de colonnes de celle-ci est passé de oldCount à newCount.

[protected slot] void QTreeView::columnMoved()

Cette méthode est appelée chaque fois qu'une colonne a été déplacée.

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

Cette fonction est appelée chaque fois que la taille de column est modifiée dans l'en-tête. oldSize et newSize renvoient respectivement l'ancienne taille et la nouvelle taille en pixels.

Voir également setColumnWidth().

int QTreeView::columnViewportPosition(int column) const

Renvoie la position horizontale de l'column e dans la fenêtre d'affichage.

int QTreeView::columnWidth(int column) const

Renvoie la largeur de l'objet ` column`.

Voir également resizeColumnToContents() et setColumnWidth().

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

Réimplémente : 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>())

Réimplémente : QAbstractItemView::dataChanged(const QModelIndex &topLeft, const QModelIndex &bottomRight, const QList<int> &roles).

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

Réimplémente : QAbstractItemView::dragMoveEvent(QDragMoveEvent *event).

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

Dessine les branches dans l'arborescence sur la même ligne que l'élément du modèle index, en utilisant l'painter fournie. Les branches sont dessinées dans le rectangle spécifié par rect.

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

Affiche la ligne de l'arborescence contenant l'élément de modèle index, à l'aide de l'painter fournie. L'option contrôle la manière dont l'élément est affiché.

Voir également setAlternatingRowColors().

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

Dessine la partie de l'arbre qui coupe l'region donnée à l'aide de l'painter spécifiée.

Voir également paintEvent().

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

Développe l'élément du modèle spécifié par l'index.

Voir également expanded().

[slot] void QTreeView::expandAll()

Déplie tous les éléments pouvant être dépliés.

Voir également collapseAll(), expand(), collapse() et setExpanded().

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

Développe l'élément situé à l'index indiquée, ainsi que tous ses enfants, jusqu'à l'depth indiquée. L'depth est relative à l'index indiquée. Une depth de -1 développera tous les enfants, tandis qu'une depth de 0 ne développera que l'index indiquée.

Voir aussi expandAll().

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

Déplie tous les éléments dépliables selon l'depth ion indiquée.

Voir également expandAll(), collapseAll(), expand(), collapse() et setExpanded().

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

Ce signal est émis lorsque l'élément spécifié par « index » est développé.

Voir également setExpanded().

QHeaderView *QTreeView::header() const

Renvoie l'en-tête de l'arborescence.

Voir également setHeader() et QAbstractItemModel::headerData().

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

Masque l'column s fournies.

Voir également ` showColumn()` et ` setColumnHidden()`.

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

Réimplémente : QAbstractItemView::horizontalOffset() const.

Renvoie le décalage horizontal des éléments dans l’arborescence.

Notez que l'arborescence utilise les positions horizontales des en-têtes pour déterminer les positions des colonnes dans la vue.

Voir également verticalOffset().

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

Renvoie l'index du modèle de l'élément situé au-dessus de « index ».

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

Réimplémente : QAbstractItemView::indexAt(const QPoint &point) const.

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

Renvoie l'index du modèle de l'élément situé à l'adresse suivante : index.

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

Renvoie l'indication de taille pour la ligne indiquée par index.

Voir également sizeHintForColumn() et uniformRowHeights().

bool QTreeView::isColumnHidden(int column) const

Renvoie « true » si l'column est masquée ; sinon, renvoie « false ».

Voir également hideColumn() et isRowHidden().

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

Renvoie « true » si l'élément du modèle « index » est développé ; sinon, renvoie « false ».

Voir également expand(), expanded() et setExpanded().

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

Renvoie « true » si l'élément de la première colonne de l'row, dans l'parent, s'étend sur toutes les colonnes ; sinon, renvoie « false ».

Voir également setFirstColumnSpanned().

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

Réimplémentation de : QAbstractItemView::isIndexHidden(const QModelIndex &index) const.

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

Renvoie « true » si l'élément situé à l'row spécifiée de l'parent est masqué ; sinon, renvoie « false ».

Voir également setRowHidden() et isColumnHidden().

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

Renvoie le rectangle occupé par l'indicateur d'expansion/de réduction de l'élément situé à l'adresse index. Si l'élément ne dispose pas d'un tel indicateur, par exemple parce qu'il n'a pas d'enfants ou parce que la décoration racine est désactivée, le rectangle renvoyé n'est pas valide. Une fonction « index » non valide renvoie également un rectangle non valide.

Cette fonction a été introduite dans Qt 6.12.

Voir également visualRect() et QStyle::SE_TreeViewDisclosureItem.

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

Réimplémente : QAbstractItemView::keyPressEvent(QKeyEvent *event).

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

Réimplémente : QAbstractItemView::keyboardSearch(const QString &search).

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

Réimplémente : QAbstractItemView::mouseDoubleClickEvent(QMouseEvent *event).

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

Réimplémente : QAbstractItemView::mouseMoveEvent(QMouseEvent *event).

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

Réimplémente : QAbstractItemView::mousePressEvent(QMouseEvent *event).

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

Réimplémente : QAbstractItemView::mouseReleaseEvent(QMouseEvent *event).

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

Réimplémente : QAbstractItemView::moveCursor(QAbstractItemView::CursorAction cursorAction, Qt::KeyboardModifiers modifiers).

Déplace le curseur selon les instructions décrites dans ` cursorAction`, en utilisant les informations fournies par le bouton ` modifiers`.

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

Réimplémente : QAbstractScrollArea::paintEvent(QPaintEvent *event).

[override virtual] void QTreeView::reset()

Réimplémente : QAbstractItemView::reset().

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

Redimensionne l'column en fonction de la taille de son contenu.

Voir également columnWidth(), setColumnWidth(), sizeHintForColumn() et QHeaderView::resizeContentsPrecision().

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

Renvoie la hauteur de la ligne indiquée par l'index.

Voir aussi indexRowSizeHint().

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

Réimplémentation de : QAbstractItemView::rowsAboutToBeRemoved(const QModelIndex &parent, int start, int end).

Indique à la vue que les lignes comprises entre la ligne « start » et la ligne « end », ces deux lignes incluses, sont sur le point d'être supprimées de l'élément de modèle « parent » donné.

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

Réimplémente : QAbstractItemView::rowsInserted(const QModelIndex &parent, int start, int end).

Indique à la vue que les lignes comprises entre la ligne start et la ligne end, ces deux lignes incluses, ont été insérées dans l'élément de modèle parent.

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

Indique que les lignes comprises entre la ligne « start » et la ligne « end » (ces deux lignes incluses) ont été supprimées de l'élément de modèle parent spécifié.

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

Réimplémente : QAbstractScrollArea::scrollContentsBy(int dx, int dy).

Fait défiler le contenu de l'arborescence de (dx, dy).

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

Réimplémente : QAbstractItemView::scrollTo(const QModelIndex &index, QAbstractItemView::ScrollHint hint).

Fait défiler le contenu de l'arborescence jusqu'à ce que l'élément de modèle spécifié index soit visible. Le paramètre hint précise l'emplacement exact où l'élément doit se trouver à l'issue de l'opération. Si l'un des parents de l'élément de modèle est réduit, il sera développé afin de garantir la visibilité de l'élément de modèle.

[override virtual] void QTreeView::selectAll()

Réimplémente : QAbstractItemView::selectAll().

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

Réimplémente : QAbstractItemView::selectedIndexes() const.

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

Réimplémente : QAbstractItemView::selectionChanged(const QItemSelection &selected, const QItemSelection &deselected).

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

Si hide est vrai, l'column est masqué ; dans le cas contraire, l'column s'affiche.

Voir également isColumnHidden(), hideColumn() et setRowHidden().

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

Définit la largeur de l'column on indiquée sur la valeur width spécifiée.

Voir également columnWidth() et resizeColumnToContents().

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

Définit l'élément référencé par index comme « replié » ou « développé », selon la valeur de expanded.

Voir également expanded(), expand() et isExpanded().

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

Si span est vrai, l'élément de la première colonne de la page row dont l'parent est indiquée s'étend sur toutes les colonnes ; dans le cas contraire, tous les éléments de la page row sont affichés.

Voir également isFirstColumnSpanned().

void QTreeView::setHeader(QHeaderView *header)

Définit l'en-tête de l'arborescence sur l'header on fournie.

La vue prend possession de l'header spécifié et le supprime lorsqu'un nouvel en-tête est défini.

Voir aussi QAbstractItemModel::headerData().

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

Réimplémente : QAbstractItemView::setModel(QAbstractItemModel *model).

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

Réimplémente : QAbstractItemView::setRootIndex(const QModelIndex &index).

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

Si hide est vrai, la page row, dont l'parent est indiquée, est masquée ; dans le cas contraire, la page row s'affiche.

Voir également isRowHidden() et setColumnHidden().

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

Réimplémente : QAbstractItemView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags flags).

Applique la sélection command aux éléments situés dans le rectangle ou touchés par celui-ci, rect.

Voir également selectionCommand().

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

Réimplémente : QAbstractItemView::setSelectionModel(QItemSelectionModel *selectionModel).

void QTreeView::setTreePosition(int index)

Cela spécifie que la structure arborescente doit être placée à l'index logique index. Si est défini sur -1, l'arborescence suivra toujours l'index visuel 0.

Voir également treePosition(), QHeaderView::swapSections() et QHeaderView::moveSection().

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

Affiche l'column ion indiquée dans l'arborescence.

Voir également ` hideColumn()` et ` setColumnHidden()`.

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

Réimplémente : QAbstractItemView::sizeHintForColumn(int column) const.

Renvoie l'indication de taille pour la largeur de l'column ou -1 s'il n'y a pas de modèle.

Si vous devez définir la largeur d'une colonne donnée à une valeur fixe, appelez ` QHeaderView::resizeSection()` sur l'en-tête de la vue.

Si vous réimplémentez cette fonction dans une sous-classe, notez que la valeur que vous renvoyez n'est utilisée que lorsque resizeColumnToContents() est appelée. Dans ce cas, si une largeur de colonne supérieure est requise soit par l'en-tête de la vue, soit par le délégué d'élément, c'est cette largeur qui sera utilisée à la place.

Voir également QWidget::sizeHint, header() et QHeaderView::resizeContentsPrecision().

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

Trie le modèle en fonction des valeurs des paramètres column et order.

column Peut prendre la valeur -1, auquel cas aucun indicateur de tri ne s'affichera et le modèle reviendra à son ordre naturel, non trié. Notez que tous les modèles ne prennent pas en charge cette fonctionnalité et peuvent même se bloquer dans ce cas.

Voir également sortingEnabled.

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

Réimplémente : QAbstractItemView::timerEvent(QTimerEvent *event).

int QTreeView::treePosition() const

Renvoie l'index logique sur lequel l'arborescence est définie. Si la valeur renvoyée est -1, cela signifie que l'arborescence est placée sur l'index visuel 0.

Voir aussi setTreePosition().

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

Réimplémente : QAbstractItemView::updateGeometries().

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

Réimplémente : QAbstractItemView::verticalOffset() const.

Renvoie le décalage vertical des éléments dans l'arborescence.

Voir aussi horizontalOffset().

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

Réimplémente : QAbstractItemView::viewportEvent(QEvent *event).

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

Réimplémente : QAbstractItemView::viewportSizeHint() const.

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

Réimplémente : ` QAbstractItemView::visualRect(const QModelIndex &index) const`.

Renvoie le rectangle occupé par l'élément situé à l'adresse index dans la fenêtre d'affichage. Si l'élément n'est pas visible ou s'il est explicitement masqué, le rectangle renvoyé n'est pas valide.

Voir également itemDecorationRect().

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

Réimplémente : QAbstractItemView::visualRegionForSelection(const QItemSelection &selection) const.

Renvoie le rectangle correspondant à la fenêtre d'affichage des éléments de l'selection donné.

Depuis la version 4.7, la région renvoyée ne contient que les rectangles qui coupent (ou sont inclus dans) la zone d'affichage.