NAME¶
MacroCmd - a command that composes other commands
SYNOPSIS¶
#include <Unidraw/Commands/macro.h>
DESCRIPTION¶
MacroCmd composes other commands in a linear fashion. Executing a MacroCmd is
equivalent to executing its children in preorder.
PUBLIC OPERATIONS¶
- MacroCmd(ControlInfo*)
- MacroCmd(
- Editor* = nil,
- Command* first = nil, Command* second = nil,
- Command* third = nil, Command* fourth = nil
- )
-
Construct a MacroCmd instance, optionally supplying up to four of its child
commands.
- virtual void Execute()
- virtual void Unexecute()
- virtual boolean Reversible()
- Execute simply executes each child, from first to last.
Unexecute calls Unexecute on each child, from last to first. The MacroCmd
is reversible if any of its children are.
- virtual void SetEditor(Editor*)
- SetEditor calls SetEditor on each child with the given
argument.
- Command* GetCommand(Iterator)
- void SetCommand(Command*, Iterator&)
- GetCommand returns the child Command to which an iterator
points. SetCommand initializes the iterator to point to a particular child
Command; it initializes the iterator to point to a nil instance if the
given Command is not a child.
- void Append(
- Command*, Command* = nil, Command* = nil, Command* =
nil
- )
- void Prepend(
- Command*, Command* = nil, Command* = nil, Command* =
nil
- )
- void InsertAfter(Iterator, Command*)
- void InsertBefore(Iterator, Command*)
- void Remove(Command*)
- void Remove(Iterator&)
- Operations that modify the MacroCmd's list of children.
Append and Prepend add up to four Commands to the end and the beginning of
the list, respectively. InsertAfter and InsertBefore insert a Command
after and before the Command pointed to by the iterator, respectively. The
Remove operations remove a child from the list without deleting it. You
can remove a child by referring to it explicitly or by specifying an
iterator. If an iterator is supplied, the Remove operation should advance
it to point to the following child as a side effect.
PROTECTED OPERATIONS¶
- Command* Cmd(UList*)
- UList* Elem(Iterator)
- Convenience functions for extracting a Command from a UList
element a UList from an iterator, respectively.
SEE ALSO¶
Command(3U), Iterator(3U), UList(3U)