Copyright © 2001-2023 MultiMedia Soft

TracksBoard.ItemTrackSet method

Previous pageReturn to chapter overviewNext page

Remarks

 

Modifies the track where the given sound item is placed. The current track can be obtained through the TracksBoard.ItemTrackGet method.

 

Items overlapping is not permitted so, if the move to the new track should cause an overlapping, this call would not move the item at all: you can check if the move to the new track was effective by invoking the TracksBoard.ItemTrackGet method.

 

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.ItemTrackSet (

nUniqueId as Long,

nTrack as Integer

) as enumErrorCodes


 

[C++]

short control.TracksBoard.ItemTrackSet (

long nUniqueId,

short nTrack

);


 

Parameter

Description

 

 

nUniqueId

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

TracksBoard.ItemClone when an existing item has been cloned

nTrack

The new zero-based track for the item

 

 

 

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