Main Content

TriggerRepeat

Specify number of additional times to execute trigger

Description

The TriggerRepeat property specifies the number of additional times you want the object to execute a trigger. This table describes the behavior for several typical TriggerRepeat values.

Value

Behavior

0 (default)

Execute the trigger once when the trigger condition is met.

Any positive integer

Execute the trigger the specified number of additional times when the trigger condition is met.

Inf

Keep executing the trigger every time the trigger condition is met until the stop function is called or an error occurs.

To determine how many triggers have executed, check the value of the TriggersExecuted property.

Note

If the FramesPerTrigger property is set to Inf, the object ignores the value of the TriggerRepeat property.

Characteristics

Access

Read only while running

Data type

double

Values

Any nonnegative integer. The default value is 0 (zero).