QUndoGroup 类

成员函数文档

[explicit] QUndoGroup::QUndoGroup(QObject *parent = nullptr)

创建一个具有父对象 parent 的空 QUndoGroup 对象。

另请参阅addStack().

[virtual noexcept] QUndoGroup::~QUndoGroup()

销毁 QUndoGroup。

QUndoStack *QUndoGroup::activeStack() const

返回此组的活动堆栈。

如果没有堆栈处于活动状态，或者组为空，则此函数返回 nullptr。

另请参阅setActiveStack() 和 QUndoStack::setActive().

[signal] void QUndoGroup::activeStackChanged(QUndoStack *stack)

当组的活动堆栈发生变化时，会发出该信号。这可以在调用 setActiveStack() 或 QUndoStack::setActive() 时发生，或者当活动堆栈从组中删除时。 stack 是新的活动堆栈。如果没有活动堆栈，则 stack 为 0。

另请参阅setActiveStack() 和 QUndoStack::setActive().

void QUndoGroup::addStack(QUndoStack *stack)

将堆栈添加到该组。该组不拥有堆栈。另一种将堆栈添加到组的方法是通过指定 QObject 作为堆栈的父类在 QUndoStack::QUndoStack()). 在这种情况下，堆栈将与组一起删除，方法与 QObjects 的常规方法相似。

另请参阅removeStack()、stacks() 和 QUndoStack::QUndoStack()。

bool QUndoGroup::canRedo() const

返回活动堆栈的 QUndoStack::canRedo 的值。

如果没有活动堆栈，或者组为空，此函数返回 false.

另请参阅canUndo() 和 setActiveStack()。

[信号] void QUndoGroup::canRedoChanged(bool canRedo)

只要活动堆栈发出 QUndoStack::canRedoChanged 或活动堆栈改变，就发出此信号。

canRedo 是新状态，如果活动堆栈为 0，则为 false。

另请参阅QUndoStack::canRedoChanged() 和 setActiveStack()。

bool QUndoGroup::canUndo() const

返回活动堆栈的 QUndoStack::canUndo 的值。

如果没有活动堆栈，或者组为空，此函数返回 false.

另请参阅canRedo() 和 setActiveStack()。

[信号] void QUndoGroup::canUndoChanged(bool canUndo)

只要活动堆栈发出 QUndoStack::canUndoChanged 或活动堆栈改变，就发出此信号。

canUndo 是新状态，如果活动堆栈为 0，则为 false。

另请参阅QUndoStack::canUndoChanged() 和 setActiveStack()。

[信号] void QUndoGroup::cleanChanged(bool clean)

只要活动堆栈发出 QUndoStack::cleanChanged 或活动堆栈改变，就发出此信号。

clean 是新状态，如果活动堆栈为 0，则为 true。

另请参阅QUndoStack::cleanChanged() 和 setActiveStack()。

QAction *QUndoGroup::createRedoAction(QObject *parent, const QString &prefix = QString()) const

创建具有父级 parent 的重做 QAction 对象。

触发此操作将在活动堆栈上调用 QUndoStack::redo，此操作的文本将在下一次调用 redo 时使用，前面加上 prefix。如果没有可重做的命令，如果组为空或没有活动堆栈，则此操作将被禁用。

如果 prefix 为空，则将使用默认模板 "重做 %1" 替代前缀。在 Qt 4.8 之前，默认使用了 "重做"。

另请参阅 createUndoAction()，canRedo()，以及 QUndoCommand::text。

QAction *QUndoGroup::createUndoAction(QObject *parent, const QString &prefix = QString()) const

创建一个有父对象的撤销QAction对象。

触发此操作将在活动栈上调用QUndoStack::undo()。这个动作的文本将始终是在undo()的下一个调用中将被撤销的命令的文本，前面加上prefix。如果没有可撤销的命令，如果组是空的或者没有栈是活动的，则此操作将禁用。

如果prefix为空，将使用默认模板"撤销%1"而不是前缀。在Qt 4.8之前，默认前缀为"撤销"。

另请参阅 createRedoAction，canUndo，以及 QUndoCommand::text。

[信号] void QUndoGroup::indexChanged(int idx)

每当活动栈发出QUndoStack::indexChanged()或者活动栈发生变化时，都会发出此信号。

idx是新的当前索引，或者活动栈为0时为0。

另请参阅 QUndoStack::indexChanged() 和 setActiveStack。

bool QUndoGroup::isClean() const

返回活动栈的 QUndoStack::isClean 的值。

如果没有栈是活动的或组为空，此函数返回true。

另请参阅 setActiveStack。

[槽] void QUndoGroup::redo()

在活动栈上调用QUndoStack::redo()。

如果没有栈是活动的或组为空，此函数不执行任何操作。

另请参阅 undo，canRedo，以及 setActiveStack。

QString QUndoGroup::redoText() const

返回活动栈的 QUndoStack::redoText 的值。

如果没有栈是活动的或组为空，此函数返回空字符串。

另请参阅 undoText 和 setActiveStack。

[信号] void QUndoGroup::redoTextChanged(const QString &redoText)

每当活动栈发出QUndoStack::redoTextChanged()或者活动栈发生变化时，都会发出此信号。

redoText是新的状态，或者活动栈为0时为空字符串。

另请参阅 QUndoStack::redoTextChanged 和 setActiveStack。

void QUndoGroup::removeStack(QUndoStack *stack)

从该组中移除stack。如果该栈是组中的活动栈，则活动栈变为0。

另请参阅 addStack()，stacks()和QUndoStack::~QUndoStack。

[slot] void QUndoGroup::setActiveStack(QUndoStack *stack)

将此组的活动栈设置为stack。

如果栈不是此组的成员，此函数不执行任何操作。

与在stack上调用QUndoStack::setActive()相同。

由createUndoAction()和createRedoAction()返回的操作将像stack的QUndoStack::createUndoAction()和QUndoStack::createRedoAction()返回的操作那样执行。

另请参阅 QUndoStack::setActive() 和 activeStack。

QList<QUndoStack *> QUndoGroup::stacks() const

返回此组中栈的列表。

另请参阅 addStack()和removeStack。

[slot] void QUndoGroup::undo()

在活动栈上调用QUndoStack::undo。

如果没有栈是活动的或组为空，此函数不执行任何操作。

另请参阅 redo，canUndo和setActiveStack。

QString QUndoGroup::undoText() const

返回活动栈的QUndoStack::undoText的值。

如果没有栈是活动的或组为空，此函数返回空字符串。

另请参阅 redoText和setActiveStack。

[signal] void QUndoGroup::undoTextChanged(const QString &undoText)

每当活动栈触发QUndoStack::undoTextChanged或活动栈更改时，该信号被发出。

undoText是新状态，或者当活动栈为0时为空字符串。

另请参阅 QUndoStack::undoTextChanged和setActiveStack。