QTreeView Class

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

Documentation des fonctions membres

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

Construit une vue arborescente avec parent pour représenter les données d'un modèle. Utilisez setModel() pour définir le modèle.

Voir aussi QAbstractItemModel.

[virtual noexcept] QTreeView::~QTreeView()

Détruit 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 de modèle spécifié par index.

Voir aussi collapsed().

[slot] void QTreeView::collapseAll()

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

Voir aussi 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 réduit.

int QTreeView::columnAt(int x) const

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

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

Informe l'arborescence que le nombre de colonnes de l'arborescence est passé de oldCount à newCount.

[protected slot] void QTreeView::columnMoved()

Ce slot est appelé 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 indiquent la taille précédente et la nouvelle taille en pixels.

Voir aussi setColumnWidth().

int QTreeView::columnViewportPosition(int column) const

Renvoie la position horizontale de column dans la fenêtre de visualisation.

int QTreeView::columnWidth(int column) const

Renvoie la largeur du site column.

Voir aussi 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 de l'arborescence sur la même ligne que l'élément de modèle index, à l'aide de painter. 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

Dessine la ligne de l'arborescence qui contient l'élément de modèle index, en utilisant le painter donné. L'adresse option contrôle la manière dont l'élément est affiché.

Voir aussi setAlternatingRowColors().

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

Dessine la partie de l'arbre qui croise l'adresse region donnée en utilisant l'adresse painter spécifiée.

Voir aussi paintEvent().

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

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

Voir aussi expanded().

[slot] void QTreeView::expandAll()

Développe tous les éléments extensibles.

Voir aussi collapseAll(), expand(), collapse() et setExpanded().

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

Développe l'élément à l'adresse index et tous ses enfants jusqu'à l'adresse depth. L'adresse depth est relative à l'adresse index. Un depth de -1 étend tous les enfants, un depth de 0 n'étend que le index donné.

Voir aussi expandAll().

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

Développe tous les éléments extensibles jusqu'à l'adresse depth.

Voir aussi 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 aussi setExpanded().

QHeaderView *QTreeView::header() const

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

Voir aussi setHeader() et QAbstractItemModel::headerData().

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

Cache l'adresse column donnée.

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 de l'arborescence.

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

Voir également verticalOffset().

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

Renvoie l'indice 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'indice du modèle de l'élément situé en dessous de index.

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

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

Voir aussi sizeHintForColumn() et uniformRowHeights().

bool QTreeView::isColumnHidden(int column) const

Renvoie true si column est caché ; sinon, renvoie false.

Voir aussi hideColumn() et isRowHidden().

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

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

Voir aussi 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 row de parent couvre toutes les colonnes ; sinon, renvoie false.

Voir aussi setFirstColumnSpanned().

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

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

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

Renvoie true si l'élément du site row de parent est caché ; sinon, renvoie false.

Voir aussi setRowHidden() et isColumnHidden().

[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 de la manière décrite par 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 le site column en fonction de la taille de son contenu.

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

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

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

Voir aussi indexRowSizeHint().

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

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

Informe la vue que les lignes allant de la ligne start à la ligne end incluse 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).

Informe la vue que les lignes allant de la ligne start à la ligne end incluse 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)

Informe la vue que les lignes allant de la ligne start à la ligne end incluse ont été supprimées de l'élément de modèle parent donné.

[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 par (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 donné index soit visible. Le paramètre hint précise l'emplacement de l'élément après l'opération. Si l'un des parents de l'élément de modèle est réduit, il sera développé pour s'assurer que l'élément de modèle est visible.

[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, column est caché, sinon column est affiché.

Voir aussi isColumnHidden(), hideColumn(), et setRowHidden().

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

Fixe la largeur de l'adresse column à l'adresse width spécifiée.

Voir aussi columnWidth() et resizeColumnToContents().

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

Définit l'élément auquel se réfère index comme étant soit réduit, soit développé, en fonction de la valeur de expanded.

Voir aussi 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 avec la valeur parent est affiché sur toutes les colonnes, sinon tous les éléments de la page row sont affichés.

Voir aussi isFirstColumnSpanned().

void QTreeView::setHeader(QHeaderView *header)

Définit l'en-tête de la vue arborescente à l'adresse header.

La vue est propriétaire de l'adresse header et la 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, l'adresse row avec l'adresse parent est cachée, sinon l'adresse row est affichée.

Voir aussi 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)

Cette valeur indique que l'arborescence doit être placée à l'index logique index. Si vaut -1, l'arbre suivra toujours l'indice visuel 0.

Voir aussi treePosition(), QHeaderView::swapSections() et QHeaderView::moveSection().

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

Affiche le site column dans l'arborescence.

Voir aussi hideColumn() et setColumnHidden().

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

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

Renvoie l'indice de taille pour la largeur de 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é. Dans ce cas, si une largeur de colonne plus importante est requise par l'en-tête de la vue ou par le délégué de l'élément, cette largeur 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 indiquées dans column et order.

column peut être -1, auquel cas aucun indicateur de tri ne sera affiché et le modèle reprendra son ordre naturel, non trié. Notez que tous les modèles ne supportent pas cette fonction 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'indice logique sur lequel l'arbre est placé. Si la valeur de retour est -1, l'arbre est placé à 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 également 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 de la fenêtre de visualisation occupé par l'élément à l'adresse index. Si l'index n'est pas visible ou explicitement caché, le rectangle renvoyé n'est pas valide.

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

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

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

Depuis la version 4.7, la région renvoyée ne contient que les rectangles intersectant (ou inclus dans) la fenêtre.