Classes > TracksBoard class > Methods > TracksBoard.ItemAttachToNext method

Remarks

Moves the position of the given sound item in order to attach it to the next existing one on the same track; the request is ignored if no other item is available on the same track.

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 class section.

Syntax

[Visual Basic]

Public Function ItemAttachToNext (

nUniqueId as Int32

) as enumErrorCodes

[C#]

public enumErrorCodes ItemAttachToNext (

Int32 nUniqueId

);

[C++]

public: enumErrorCodes ItemAttachToNext (

Int32 nUniqueId

);

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

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