COM Objects > TracksBoard object > Methods > TracksBoard.ItemOffsetSet method

Remarks

Modifies the offset of a specific item respect to the beginning of the session. The current offset can be obtained through the TracksBoard.ItemOffsetGet method.

Important note about items overlapping

Overlapping of two items on the same track is now allowed so, in case the offset change should cause an overlapping and upon space availability, the item will be automatically moved to the next track or to the previous track; if both previous and next tracks should in any case suffer an overlapping, a new track will be automatically inserted on the nearest position.

For details about the use of the TracksBoard refer to the How to use the TracksBoard to visually compose songs tutorial.

For further details about methods of the TracksBoard refer to the TracksBoard object section.

Syntax

[Visual Basic]

control.TracksBoard.ItemOffsetSet (

nUniqueId as Long,

nOffsetMs as Long

) as enumErrorCodes

[C++]

short control.TracksBoard.ItemOffsetSet (

long nUniqueId,

long nOffsetMs

);

Parameter

Description

nUniqueId

Unique identification number assigned to the sound item after being generated by one of the following methods:

•	TracksBoard.ItemSoundFileAdd and TracksBoard.ItemSoundFileRawAdd for sound files

•	TracksBoard.ItemSpeechFromStringAdd and TracksBoard.ItemSpeechFromFileAdd for text to speech items

•	TracksBoard.ItemClone when an existing item has been cloned

nOffsetMs

New offset of the item, expressed in milliseconds.

This value can be modified at any time on the TracksBoard user interface through mouse interaction.

Return value

Value	Meaning

Negative value	An error occurred, check the LastError property value in order to get the error code
enumErrorCodes.ERR_NOERROR (0)	The method call was successful