Copyright © 2001-2018 MultiMedia Soft

CuePointsAdd method

Previous pageReturn to chapter overviewNext page



Adds a cue point to the given player: when the cue point is reached, the CuePointReached event is fired.


Cue points positioning is always referred to the original sound duration, meaning that it won't keep count of eventual tempo and/or playback rate changes and will always refer to the position of the song as it should be played at its original speed.


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





[Visual Basic]

control.CuePointsAdd (

nPlayer as Integer,

strCuePointName as String,

nCuePointPos as Long

) as enumErrorCodes



short control.CuePointsAdd (

short nPlayer,

LPCTSTR strCuePointName,

long nCuePointPos









Number representing the zero-based index of the involved player


String containing the unique name that will identify the cue point from now on.

If this name should be already assigned to an existing cue point, an error code would be returned


Number representing the cue point position expressed in milliseconds



Return value






Negative value

An error occurred (see the LastError property for further error details)

enumErrorCodes.ERR_NOERROR (0)

The method call was successful.