Page tree
Skip to end of metadata
Go to start of metadata

onSaveSubPreset(section)

Description

This callback function is called when saving a subpreset with a corresponding Preset Browser template. The callback will only be called if the scope of the Preset Browser template is set correctly.

  • If the MacroPage with the Preset Browser template is attached to an element other than the script module (e.g., the program), the scope must be set to the script module (e.g., @0:Script Module).
  • If the MacroPage with the Preset Browser template is attached to the script module itself, the scope does not need to be set.

In addition, the Preset Browser Custom template allows to define a section for the subpreset. When you save a subpreset, the section will be passed on from the Preset Browser Custom template to the callback. You can manage different subsets of parameters by using the section as condition for an if statement that stores only the parameters of interest. The data you pass on to the return statement will be stored with the subpreset. The data can be of any type, but it is common practice to use a table that can easily be extended with more fields. When the subpreset is restored, the onLoadSubPreset callback will receive the stored data.

Scope and section are template parameters. You can set them in the MacroPage Designer on the properties pane of the Preset Browser and Preset Browser Custom templates.

Available in: Controller.

Arguments

sectionThe section as defined in the Preset Browser Custom template.string

Return Values

The returned data will be stored in a subpreset.

Example

See Also: onLoadSubPreset

2 Comments

  1. Reminder: Please link this page to the documentation of the preset template, once it is available.