|
TracksBoard.ItemClone method |
  
|
|
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 object section.
Syntax
[Visual Basic] control.TracksBoard.ItemClone ( nUniqueId as Long, nTotalClones as Long, bSameVolumePoints as enumBoolean, bSameAmplitude as enumBoolean, bSameFading as enumBoolean ) as enumErrorCodes |
[C++] short control.TracksBoard.ItemClone ( long nUniqueId, long nTotalClones, short bSameVolumePoints, short bSameAmplitude, short bSameFading ); |
Parameter |
Description |
||||||
|
|
||||||
nUniqueId |
Unique identification number assigned to the sound item after being generated by one of the following methods:
|
||||||
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:
|
||||||
bSameAmplitude |
Boolean flag specifying if item's current amplitude must be cloned as well. Supported values are the following:
|
||||||
bSameFading |
Boolean flag specifying if item's existing fading must be cloned as well. Supported values are the following:
|
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 |
