QUndoGroup Class Reference

[QtGui module]

该QUndoGroup类是一组QUndoStack对象。More…

继承QObject

Methods

  • __init__ (self, QObject parent = None)
  • QUndoStack activeStack (self)
  • addStack (self, QUndoStack stack)
  • bool canRedo (self)
  • bool canUndo (self)
  • QAction createRedoAction (self, QObject parent, QString prefix = QString())
  • QAction createUndoAction (self, QObject parent, QString prefix = QString())
  • bool isClean (self)
  • redo (self)
  • QString redoText (self)
  • removeStack (self, QUndoStack stack)
  • setActiveStack (self, QUndoStack stack)
  • list-of-QUndoStack stacks (self)
  • undo (self)
  • QString undoText (self)

Qt Signals

  • void activeStackChanged (QUndoStack *)
  • void canRedoChanged (bool)
  • void canUndoChanged (bool)
  • void cleanChanged (bool)
  • void indexChanged (int)
  • void redoTextChanged (const QString&)
  • void undoTextChanged (const QString&)

Detailed Description

该QUndoGroup类是一组QUndoStack对象。

对于Qt的撤消框架的概述,请参阅overview

一个应用程序通常有多个撤消堆栈,每一个打开的文档。与此同时,应用程序通常有一个撤消操作和一个重做动作,这会触发撤消或重做的活动文档。

QUndoGroup是一组QUndoStack物,其中之一可以是活动的。它有一个undo()和redo()槽,它调用QUndoStack.undo()和QUndoStack.redo( )为活动堆栈。它还具有功能createUndoAction()和createRedoAction( ) 。这些函数返回的动作相同的行为方式的那些返回QUndoStack.createUndoAction()和QUndoStack.createRedoAction活动堆栈的() 。

堆栈被添加到一个组addStack( )中,用去除removeStack( ) 。堆栈是隐式添加到组时,同组创建为其父QObject

这是程序员的责任来指定堆栈积极通过调用QUndoStack.setActive( ) ,通常当相关文档窗口接收焦点。活动堆栈也可与设置setActiveStack() ,并且通过返回activeStack( ) 。

当一个堆栈使用添加到组addStack( ) ,该组不采取栈的所有权。这意味着在堆栈必须单独从组中删除。当一个堆栈被删除,它会自动从组中删除。堆栈只能属于一个组。将它添加到另一个组将导致它从以前的组中删除。

一个QUndoGroup也是有用会同QUndoView。如果QUndoView设置为观看利用一组QUndoView.setGroup( ) ,它会自动更新以显示当前堆栈。


Method Documentation

  1. QUndoGroup.__init__ (self, QObject parent = None)

parent的说法,如果不是没有,原因self通过Qt的,而不是PyQt的拥有。

创建一个空的QUndoGroup与父对象parent

See also addStack( ) 。

  1. QUndoStack QUndoGroup.activeStack (self)

[

返回该组的活动堆栈。

如果没有堆叠的活跃,或者如果组为空,则该函数返回0 。

]($docs-qundostack.html)

See also setActiveStack()和QUndoStack.setActive( ) 。

  1. QUndoGroup.addStack (self, QUndoStack stack)

添加stack这一组。本集团不会采取栈的所有权。增加堆栈的一组的另一种方式是通过指定组为堆栈的父QObjectQUndoStack.QUndoStack( ) 。在这种情况下,堆叠时的组被删除被删除,在以通常的方式QObjects

See also removeStack( )stacks()和QUndoStack.QUndoStack( ) 。

  1. bool QUndoGroup.canRedo (self)

返回活动堆栈的值QUndoStack.canRedo( ) 。

如果没有堆叠的活跃,或者如果组是空的,这个函数返回False 。

See also canUndo()和setActiveStack( ) 。

  1. bool QUndoGroup.canUndo (self)

返回活动堆栈的值QUndoStack.canUndo( ) 。

如果没有堆叠的活跃,或者如果组是空的,这个函数返回False 。

See also canRedo()和setActiveStack( ) 。

  1. QAction QUndoGroup.createRedoAction (self, QObject parent, QString prefix = QString())

[

parent的说法,如果不是没有,原因self通过Qt的,而不是PyQt的拥有。

]($docs-qaction.html)

创建一个重做QAction与父对象parent

触发此动作将导致调用QUndoStack.redo()在有源堆栈。这一行动的文本将永远是命令,将在下一呼叫重做文本redo( ) ,由前缀prefix。如果没有可用的重做命令,如果组为空或者如果没有一个栈的活跃,这个动作将被禁用。

If prefix为空,则默认模板“重做% 1 ”是用来代替前缀。 Qt的4.8之前,前缀“重做”被默认使用。

See also createUndoAction( )canRedo()和QUndoCommand.text( ) 。

  1. QAction QUndoGroup.createUndoAction (self, QObject parent, QString prefix = QString())

[

parent的说法,如果不是没有,原因self通过Qt的,而不是PyQt的拥有。

]($docs-qaction.html)

创建一个撤消QAction与父对象parent

触发此动作将导致调用QUndoStack.undo()在有源堆栈。这一行动的文本将永远是命令,将在下一呼叫撤消文本undo( ) ,由前缀prefix。如果没有可用的undo命令,如果组为空或者如果没有一个栈的活跃,这个动作将被禁用。

If prefix为空,则使用默认模板,而不是前缀“还原% 1 ” 。 Qt的4.8之前,前缀“撤消”被默认使用。

See also createRedoAction( )canUndo()和QUndoCommand.text( ) 。

  1. bool QUndoGroup.isClean (self)

返回活动堆栈的值QUndoStack.isClean( ) 。

如果没有堆叠的活跃,或者如果组是空的,这个函数返回True。

See also setActiveStack( ) 。

  1. QUndoGroup.redo (self)

这种方法也是一个Qt槽与C + +的签名void redo()

电话QUndoStack.redo()在有源堆栈。

如果没有堆叠的活跃,或者如果组是空的,这个函数不执行任何操作。

See also undo( )canRedo()和setActiveStack( ) 。

  1. QString QUndoGroup.redoText (self)

返回活动堆栈的值QUndoStack.redoText( ) 。

如果没有堆叠的活跃,或者如果组是空的,这个函数返回一个空字符串。

See also undoText()和setActiveStack( ) 。

  1. QUndoGroup.removeStack (self, QUndoStack stack)

移除stack从本组。如果堆栈是活动堆栈组中,活动堆栈变为0 。

See also addStack( )stacks()和QUndoStack.~QUndoStack( ) 。

  1. QUndoGroup.setActiveStack (self, QUndoStack stack)

这种方法也是一个Qt槽与C + +的签名void setActiveStack(QUndoStack *)

设置这个组的主栈stack

如果堆栈是不是该组的成员,这个函数不执行任何操作。

代名词调用QUndoStack.setActive( )上stack

返回的行动createUndoAction()和createRedoAction()现在将表现在方法一样通过返回stackQUndoStack.createUndoAction()和QUndoStack.createRedoAction( ) 。

See also QUndoStack.setActive()和activeStack( ) 。

  1. list-of-QUndoStack QUndoGroup.stacks (self)

返回该组堆叠的列表。

See also addStack()和removeStack( ) 。

  1. QUndoGroup.undo (self)

这种方法也是一个Qt槽与C + +的签名void undo()

电话QUndoStack.undo()在有源堆栈。

如果没有堆叠的活跃,或者如果组是空的,这个函数不执行任何操作。

See also redo( )canUndo()和setActiveStack( ) 。

  1. QString QUndoGroup.undoText (self)

返回活动堆栈的值QUndoStack.undoText( ) 。

如果没有堆叠的活跃,或者如果组是空的,这个函数返回一个空字符串。

See also redoText()和setActiveStack( ) 。


Qt Signal Documentation

  1. void activeStackChanged (QUndoStack *)

这是该信号的默认超载。

这个信号被发射时该组的活动堆栈变化。这可能是因为setActiveStack()或QUndoStack.setActive( )被调用时,或者当活动堆栈的形式组中删除。stack是新的活动堆栈。如果没有堆栈处于活动状态,stack为0。

See also setActiveStack()和QUndoStack.setActive( ) 。

  1. void canRedoChanged (bool)

这是该信号的默认超载。

这个信号被发射时的有效堆发射QUndoStack.canRedoChanged()或活动堆栈的变化。

canRedo是新的状态,则返回False活动堆栈为0 。

See also QUndoStack.canRedoChanged()和setActiveStack( ) 。

  1. void canUndoChanged (bool)

这是该信号的默认超载。

这个信号被发射时的有效堆发射QUndoStack.canUndoChanged()或活动堆栈的变化。

canUndo是新的状态,则返回False活动堆栈为0 。

See also QUndoStack.canUndoChanged()和setActiveStack( ) 。

  1. void cleanChanged (bool)

这是该信号的默认超载。

这个信号被发射时的有效堆发射QUndoStack.cleanChanged()或活动堆栈的变化。

clean是新的状态,或者是当活动堆栈为0 。

See also QUndoStack.cleanChanged()和setActiveStack( ) 。

  1. void indexChanged (int)

这是该信号的默认超载。

这个信号被发射时的有效堆发射QUndoStack.indexChanged()或活动堆栈的变化。

idx为新的当前索引,或者0,如果活动堆栈为0 。

See also QUndoStack.indexChanged()和setActiveStack( ) 。

  1. void redoTextChanged (const QString&)

这是该信号的默认超载。

这个信号被发射时的有效堆发射QUndoStack.redoTextChanged()或活动堆栈的变化。

redoText是新的状态,或者一个空字符串,如果活动堆栈为0 。

See also QUndoStack.redoTextChanged()和setActiveStack( ) 。

  1. void undoTextChanged (const QString&)

这是该信号的默认超载。

这个信号被发射时的有效堆发射QUndoStack.undoTextChanged()或活动堆栈的变化。

undoText是新的状态,或者一个空字符串,如果活动堆栈为0 。

See also QUndoStack.undoTextChanged()和setActiveStack( ) 。