Difference between revisions of "PresetDocFixtureView:DispatchAction"

Revision as of 09:37, 29 September 2016

DispatchAction( action, optionalParameter )

action is a string.

optionalParameter is a string (only some actions require the optionalParameter).

Available in MLA v1.3 onwards.

This function sends a user interface action to the Preset Documentation Fixture view. These actions would normally by triggered by clicking on the user interface, i.e. selecting a Preset in the Fixtures Preset table.

Example.

PresetDocFixtureView:DispatchAction("Select First Preset")

This would send an action that would be the same as clicking on the first preset in the preset list for a fixture.

PresetDocFixtureView:DispatchAction("Set Hide Ignored", "False")

This function with an optional parameter would be the same as clicking on the Hide Ignored checkbox. In this case, the it will set to False (off).

Action Strings

Select First Preset

Will select the first Preset in the Fixtures Preset table in the Preset Documentation Fixture view. It is the same as if you had clicked on the first Preset in the Preset table. Note that table will not scroll to show the selection.

Select Last Preset

Will select the last Preset in the Fixtures Preset table in the Preset Documentation Fixture view. It is the same as if you had clicked on the last Preset in the Preset table. Note that table will not scroll to show the selection.

Select Next Preset

Will select the next Preset in the Fixtures Preset table in the Preset Documentation Fixture view. If no Preset was previously selected, it will select the first Preset. Note that table will not scroll to show the selection.

Select Previous Preset

Will select the previous Preset in the Fixtures Preset table in the Preset Documentation Fixture view. If no Preset was previously selected, it will not do anything. Note that table will not scroll to show the selection.

Select Preset

parameter (string) = Preset Type and/or Preset ID. i.e.Preset,27.

Will select the specified Preset in the Fixtures Preset table in the Preset Documentation Fixture view. Note that table will not scroll to show the selection.

Examples.

PresetDocFixtureView:DispatchAction("Select Preset", "Preset,27")

This will select specifically Preset Type Preset with the Preset ID of 27.

PresetDocFixtureView:DispatchAction("Select Preset", "46")

This will select the first Preset, regardless of Preset Type with a Preset ID of 46.

Display Preset Photo

parameter (string) = Photo number (1-4).

Will display the specified preset photo for the selected preset. If the photo number is greater than the number of photos, then the last photo will be displayed.

Display First Preset Photo

Will display the first preset photo for the selected preset.

Display Last Preset Photo

Will display the last preset photo for the selected preset.

Sort By

parameter (string) = sort by item.

Only version 1.2.1 Beta 6 onwards.
Will set the Sort for the preset list.
Sort Items...

Preset Type

Preset ID

Focus Cue

Set

Focussed

Priority

The name of user created sort may also be used.

Example.

PresetDocView:DispatchAction("Sort By", "Preset ID")