TriggersAddPerc method

TriggersAddPerc method

Remarks

Adds a trigger to the given player at a certain song position: when the trigger is reached, the TriggerReached event is fired.

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

Syntax

[Visual Basic]

control.TriggersAddPerc (

nPlayer as Integer,

nTriggerID as Integer,

fTriggerPosPerc as single

[C++]

short control.TriggersAddPerc (

short nPlayer,

short nTriggerID,

float fTriggerPosPerc

);

Parameter	Description

nPlayer	Number representing the zero-based index of the involved player
nTriggerID	Number representing the identifier of the new trigger. If this identifier should be already assigned to another trigger, an error code would be returned.
fTriggerPosPerc	Number representing the trigger position expressed in percentage. If this position should be already assigned to another trigger, an error code would be returned.

Return value

Value	Meaning

Negative value	An error occurred (see the LastError property for further error details)
enumErrorCodes.ERR_NOERROR (0)	The method call was successful.