Sur cette page

QUndoView Class

La classe QUndoView affiche le contenu d'une page QUndoStack. Plus....

En-tête : #include <QUndoView>
CMake : find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake : QT += widgets
Héritages : QListView

Propriétés

Fonctions publiques

QUndoView(QWidget *parent = nullptr)
QUndoView(QUndoGroup *group, QWidget *parent = nullptr)
QUndoView(QUndoStack *stack, QWidget *parent = nullptr)
virtual ~QUndoView()
QIcon cleanIcon() const
QString emptyLabel() const
QUndoGroup *group() const
void setCleanIcon(const QIcon &icon)
void setEmptyLabel(const QString &label)
QUndoStack *stack() const

Emplacements publics

void setGroup(QUndoGroup *group)
void setStack(QUndoStack *stack)

Description détaillée

QUndoView est un site QListView qui affiche la liste des commandes placées sur une pile d'annulation. La dernière commande exécutée est toujours sélectionnée. La sélection d'une commande différente entraîne un appel à QUndoStack::setIndex(), qui fait reculer ou avancer l'état du document jusqu'à la nouvelle commande.

La pile peut être définie explicitement avec setStack(). Il est également possible de définir un objet QUndoGroup avec setGroup(). La vue se mettra alors à jour automatiquement chaque fois que la pile active du groupe changera.

Pile d'annulation affichant la liste des commandes

Documentation sur les propriétés

cleanIcon : QIcon

Cette propriété contient l'icône utilisée pour représenter l'état de propreté.

Une pile peut avoir un état propre défini avec QUndoStack::setClean(). Il s'agit généralement de l'état du document au moment où il a été enregistré. QUndoView peut afficher une icône dans la liste des commandes pour indiquer l'état propre. Si cette propriété est une icône nulle, aucune icône n'est affichée. La valeur par défaut est l'icône null.

Fonctions d'accès :

QIcon cleanIcon() const
void setCleanIcon(const QIcon &icon)

emptyLabel : QString

Cette propriété contient l'étiquette utilisée pour l'état vide.

L'étiquette empty est l'élément le plus haut dans la liste des commandes, qui représente l'état du document avant qu'aucune commande n'ait été poussée sur la pile. La valeur par défaut est la chaîne "<empty>".

Fonctions d'accès :

QString emptyLabel() const
void setEmptyLabel(const QString &label)

Documentation des fonctions membres

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

Construit une nouvelle vue avec le parent parent.

[explicit] QUndoView::QUndoView(QUndoGroup *group, QWidget *parent = nullptr)

Construit une nouvelle vue avec le parent parent et définit le groupe observé à group.

La vue se met à jour automatiquement chaque fois que la pile active du groupe change.

[explicit] QUndoView::QUndoView(QUndoStack *stack, QWidget *parent = nullptr)

Construit une nouvelle vue avec le parent parent et définit la pile observée à stack.

[virtual noexcept] QUndoView::~QUndoView()

Détruit cette vue.

QUndoGroup *QUndoView::group() const

Renvoie le groupe affiché par cette vue.

Si la vue ne regarde pas le groupe, cette fonction renvoie nullptr.

Voir aussi setGroup() et setStack().

[slot] void QUndoView::setGroup(QUndoGroup *group)

Définit le groupe affiché par cette vue à group. Si group est nullptr, la vue sera vide.

La vue se met à jour automatiquement lorsque la pile active du groupe change.

Voir également group() et setStack().

[slot] void QUndoView::setStack(QUndoStack *stack)

Définit la pile affichée par cette vue à stack. Si stack est nullptr, la vue sera vide.

Si la vue affichait précédemment un QUndoGroup, le groupe est défini sur nullptr.

Voir aussi stack() et setGroup().

QUndoStack *QUndoView::stack() const

Renvoie la pile actuellement affichée par cette vue. Si la vue regarde un site QUndoGroup, il s'agit de la pile active du groupe.

Voir aussi setStack() et setGroup().

© 2026 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.