Auf dieser Seite

QUndoView Class

Die Klasse „QUndoView“ zeigt den Inhalt eines „ QUndoStack “ an. Mehr...

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

Eigenschaften

Öffentliche Funktionen

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

Öffentliche Slots

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

Detaillierte Beschreibung

QUndoView ist ein „ QListView “, das die Liste der Befehle anzeigt, die auf einen Undo-Stack gelegt wurden. Der zuletzt ausgeführte Befehl ist immer ausgewählt. Die Auswahl eines anderen Befehls führt zu einem Aufruf von ` QUndoStack::setIndex()`, wodurch der Zustand des Dokuments zum neuen Befehl zurück- oder vorwärtsgesetzt wird.

Der Stapel kann explizit mit ` setStack()` gesetzt werden. Alternativ kann ein ` QUndoGroup `-Objekt mit ` setGroup()` gesetzt werden. Die Ansicht aktualisiert sich dann automatisch, sobald sich der aktive Stapel der Gruppe ändert.

Rückgängig-Stapel mit einer Liste der Befehle

Dokumentation zu den Eigenschaften

cleanIcon : QIcon

Diese Eigenschaft enthält das Symbol, das den „Clean“-Zustand darstellt.

Ein Stapel kann über ` QUndoStack::setClean()` einen „sauberen“ Zustand festlegen. Dies ist in der Regel der Zustand des Dokuments zum Zeitpunkt des Speichervorgangs. ` QUndoView ` kann in der Befehlsliste ein Symbol anzeigen, um den „sauberen“ Zustand darzustellen. Ist diese Eigenschaft ein Null-Symbol, wird kein Symbol angezeigt. Der Standardwert ist das Null-Symbol.

Zugriffsfunktionen:

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

emptyLabel : QString

Diese Eigenschaft enthält die Bezeichnung, die für den leeren Zustand verwendet wird.

Die Beschriftung für den leeren Zustand ist das oberste Element in der Befehlsliste und stellt den Zustand des Dokuments dar, bevor Befehle auf den Stapel gelegt wurden. Der Standardwert ist die Zeichenkette „<empty>“.

Zugriffsfunktionen:

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

Dokumentation zu den Mitgliedsfunktionen

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

Erstellt eine neue Ansicht mit dem übergeordneten Element „ parent “.

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

Erstellt eine neue Ansicht mit dem übergeordneten Element „ parent “ und legt die beobachtete Gruppe auf „ group “ fest.

Die Ansicht wird automatisch aktualisiert, sobald sich der aktive Stapel der Gruppe ändert.

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

Erstellt eine neue Ansicht mit dem übergeordneten Element „ parent “ und legt den beobachteten Stapel auf „ stack “ fest.

[virtual noexcept] QUndoView::~QUndoView()

Löscht diese Ansicht.

QUndoGroup *QUndoView::group() const

Gibt die von dieser Ansicht angezeigte Gruppe zurück.

Wenn die Ansicht keine Gruppe anzeigt, gibt diese Funktion „ nullptr “ zurück.

Siehe auch „ setGroup()“ und „ setStack()“.

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

Legt die von dieser Ansicht angezeigte Gruppe auf „ group “ fest. Wenn „ group “ auf „ nullptr “ gesetzt ist, ist die Ansicht leer.

Die Ansicht aktualisiert sich automatisch, sobald sich der aktive Stapel der Gruppe ändert.

Siehe auch „ group()“ und „ setStack()“.

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

Legt den von dieser Ansicht angezeigten Stapel auf „ stack “ fest. Wenn „ stack “ auf „ nullptr “ gesetzt ist, ist die Ansicht leer.

Wenn die Ansicht zuvor einen „ QUndoGroup “ angezeigt hat, wird die Gruppe auf „ nullptr “ gesetzt.

Siehe auch stack() und setGroup().

QUndoStack *QUndoView::stack() const

Gibt den derzeit von dieser Ansicht angezeigten Stapel zurück. Wenn die Ansicht auf eine „ QUndoGroup “ gerichtet ist, handelt es sich hierbei um den aktiven Stapel der Gruppe.

Siehe auch „ setStack()“ und „ 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.