Begins a new undo group.
- FxPlug 3.1+
The name of the undo group. Some hosts may display this name in their undo menu (i.e. "Undo Apply Preset"). This name should be localized and suitable for user display.
YES if the undo group was successfully started; otherwise
A plug-in can use this method to collapse multiple operations into one undo operation. Subsequent undo operations will be coalesced into this group until
end is called. Each call to
start must be balanced with a call to
For example, a plug-in may implement a "preset" popup, which changes the values of 20 other parameters using the FxParameterSettingAPI. By nesting the parameter changes in a
end block, the 20 changes will be collapsed into one undo operation. This allows the user to undo the preset application by hitting undo once, instead of once per each changed parameter.