TriggersSetPos method

TriggersSetPos method

Remarks

Modifies the current position for the given trigger.

See the How to add Triggers and Cue Points to a player section for further details about triggers.

Syntax

[Visual Basic]

control.TriggersSetPos (

nPlayer as Integer,

nTriggerID as Integer,

nTriggerPos as Long

[C++]

short control.TriggersSetPos (

short nPlayer,

short nTriggerID,

long nTriggerPos

);

Parameter	Description

nPlayer	Number representing the zero-based index of the involved player
nTriggerID	Number representing the identifier of the new trigger
nTriggerPos	Number representing the trigger position: it's effective value depends upon the value of the ScaleUnits property. If this position should be already assigned to another trigger, the existing trigger would be removed from the list of existing triggers and replaced by the new one.

Return value

Value	Meaning

Negative value	An error occurred (see the LastError property for further error details)
enumErrorCodes.WARNING_TRIGGER_REMOVED (1)	An existing trigger having the same position has been removed from the list of existing triggers
enumErrorCodes.ERR_NOERROR (0)	The method call was successful.