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
) as enumErrorCodes
|
|
[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.
|
|
