Copyright © 2001-2018 MultiMedia Soft

PlayListItemCuePointGet method

Previous pageReturn to chapter overviewNext page

Remarks

 

Obtains information about a specific cue point from an item of the playlist.

 

For further details about playlists management see the How to create and manage a playlist tutorial.

For details about using Volume Automation refer to the How to manage Volume Automation tutorial.

For further details about cue points see the How to add Triggers and Cue Points to a player tutorial.

 

 

Syntax

 

[Visual Basic]

control.PlayListItemCuePointGet (

nPlayer as Integer,

nItem as Integer,

nCuePointIndex as Integer,

nPositionUnit as enumVolumeAutomationPositionUnits,

fPosition as Single

) as String


 

[C++]

LPCTSTR control.PlayListItemCuePointGet (

short nPlayer,

short nItem,

short nCuePointIndex,

short nPositionUnit,

float *fPosition

);


 

 

Parameter

Description

 

 

nPlayerIndex

Number representing the zero-based index of the involved player

nItem

Number representing the zero-based index of the item inside the playlist. The number of available items can be obtained using the PlayListGetCount method.

nCuePointIndex

Number representing the zero-based index of the cue point. The number of available cue points can be obtained using the PlayListItemCuePointCountGet method.

nPositionUnit

The unit used to define the position of the cue point through the fPosition parameter below.

Supported values are the following:

Mnemonic constant

Value

Meaning

VA_POS_UNIT_SECONDS

0

Position is expressed in seconds

VA_POS_UNIT_PERCENTAGE

1

Position is expressed in percentage

VA_POS_UNIT_MILLISECONDS

2

Position is expressed in milliseconds

fPosition

Reference that, on return from the method call, will contain the position of the volume point expressed in the same unit set into the nPositionUnit parameter.

 

 

Return value

 

Value

Meaning

 

 

Empty string

The information was not available or an error occurred (see the LastError property for further error details)

Valid string

The name of the cue point