Copyright © 2001-2018 MultiMedia Soft

CuePointsAdd method

Previous pageReturn to chapter overviewNext page

Remarks

 

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.

 

 

Syntax

 

[Visual Basic]

control.CuePointsAdd (

nPlayer as Integer,

strCuePointName as String,

nCuePointPos as Long

) as enumErrorCodes


 

[C++]

short control.CuePointsAdd (

short nPlayer,

LPCTSTR strCuePointName,

long nCuePointPos

);


 

 

Parameter

Description

 

 

nPlayer

Number representing the zero-based index of the involved player

strCuePointName

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

nCuePointPos

Number representing the cue point position expressed in milliseconds

 

 

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.