Classes > TracksBoard class > Methods > TracksBoard.ItemClone method

Remarks

Clones the given item, eventually keeping all or some of its current settings.

Important note about items overlapping

Overlapping of two items on the same track is now allowed so, in case the new clone(s) should cause an overlapping and upon space availability, the clone(s) 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 class section.

Syntax

[Visual Basic]

Public Function ItemClone (

nUniqueId as Int32,

nTotalClones as Int32,

bSameVolumePoints as Boolean,

bSameAmplitude as Boolean,

bSameFading as Boolean

) as enumErrorCodes

[C#]

public enumErrorCodes ItemClone (

Int32 nUniqueId,

Int32 nTotalClones,

bool bSameVolumePoints,

bool bSameAmplitude,

bool bSameFading

);

[C++]

public: enumErrorCodes ItemClone

Int32 nUniqueId,

Int32 nTotalClones,

bool bSameVolumePoints,

bool bSameAmplitude,

bool bSameFading

);

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

nTotalClones

Total number of clones to create.

bSameVolumePoints

Boolean flag specifying if item's existing volume points must be cloned as well.

Supported values are the following:

Value	Meaning
false	Doesn't clone existing volume points.
true	Clones existing volume points.

bSameAmplitude

Boolean flag specifying if item's current amplitude must be cloned as well.

Supported values are the following:

Value	Meaning
false	Doesn't clone the current amplitude.
true	Clones the current amplitude.

bSameFading

Boolean flag specifying if item's existing fading must be cloned as well.

Supported values are the following:

Value	Meaning
false	Doesn't clone the existing fading.
true	Clones the existing fading.

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