En esta página

QUndoView Class

La clase QUndoView muestra el contenido de un « QUndoStack ». Más información...

Encabezado: #include <QUndoView>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Heredan: QListView

Propiedades

Funciones públicas

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

Ranuras públicas

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

Descripción detallada

QUndoView es un objeto de tipo « QListView » que muestra la lista de comandos almacenados en una pila de deshacer. El comando ejecutado más recientemente siempre está seleccionado. Al seleccionar un comando diferente, se invoca la función QUndoStack::setIndex(), lo que hace que el estado del documento retroceda o avance hasta el nuevo comando.

La pila se puede configurar explícitamente mediante setStack(). Como alternativa, se puede establecer un objeto QUndoGroup mediante setGroup(). La vista se actualizará automáticamente cada vez que cambie la pila activa del grupo.

Pila de deshacer con la lista de comandos

Documentación de propiedades

cleanIcon : QIcon

Esta propiedad contiene el icono utilizado para representar el estado «limpio».

Se puede establecer el estado «limpio» de una pila mediante la función ` QUndoStack::setClean()`. Suele ser el estado del documento en el momento en que se guardó. La función ` QUndoView ` puede mostrar un icono en la lista de comandos para indicar el estado «limpio». Si esta propiedad es un icono nulo, no se muestra ningún icono. El valor por defecto es el icono nulo.

Funciones de acceso:

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

emptyLabel : QString

Esta propiedad contiene la etiqueta que se utiliza para el estado vacío.

La etiqueta «empty» es el elemento más alto de la lista de comandos, que representa el estado del documento antes de que se introdujera ningún comando en la pila. El valor por defecto es la cadena «<empty>».

Funciones de acceso:

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

Documentación de funciones de miembro

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

Crea una nueva vista con el elemento padre parent.

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

Crea una nueva vista con el padre parent y establece el grupo observado en group.

La vista se actualizará automáticamente cada vez que cambie la pila activa del grupo.

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

Crea una nueva vista con « parent » como vista principal y establece la pila de observación en « stack ».

[virtual noexcept] QUndoView::~QUndoView()

Elimina esta vista.

QUndoGroup *QUndoView::group() const

Devuelve el grupo que muestra esta vista.

Si la vista no está centrada en ningún grupo, esta función devuelve « nullptr ».

Véase también setGroup() y setStack().

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

Establece el grupo que muestra esta vista en « group ». Si « group » es « nullptr », la vista estará vacía.

La vista se actualizará automáticamente cada vez que cambie la pila activa del grupo.

Véase también group() y setStack().

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

Establece la pila que muestra esta vista en stack. Si stack es nullptr, la vista estará vacía.

Si la vista mostraba anteriormente un « QUndoGroup », el grupo se establece en « nullptr ».

Véase también stack() y setGroup().

QUndoStack *QUndoView::stack() const

Devuelve la pila que muestra actualmente esta vista. Si la vista está centrada en un grupo de pila ( QUndoGroup), esta es la pila activa del grupo.

Véase también setStack() y 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.