COM Objects > SoundComposer object > Methods > SoundComposer.ItemAppendNext method

Remarks

Instructs the sound composer to append to an existing item the next item that will be added through one of the following methods: SoundComposer.ItemSoundFileAdd, SoundComposer.ItemSoundFileMemoryAdd, SoundComposer.ItemSoundFileRawAdd, SoundComposer.ItemSoundFileMemoryRawAd, SoundComposer.ItemSpeechFromFileAdd, SoundComposer.ItemSpeechFromStringAdd.

When this method is invoked successfully, the next item will be appended to the given existing item on the same audio channel of the sound composer and with the same "downmix to mono" setting. After the new item has been appended, the "append mode" is automatically reset.

For further details about sound composing see the the SoundComposer object and the How to compose a sound tutorial.

Syntax

[Visual Basic]

control.SoundGenerator.ItemAppendNext (

nPlayer as Integer,

nUniqueIdAppendTo as Long,

nOffsetFromAppendPosInMs as Long

) as enumErrorCodes

[C++]

short control.SoundGenerator.ItemAppendNext (

short nPlayer,

long nUniqueIdAppendTo,

long nOffsetFromAppendPosInMs

);

Parameter

Description

nPlayer

Number representing the zero-based index of the player that owns the sound composer session

nUniqueIdAppendTo

Unique identifier of the previously added item

nOffsetFromAppendPosInMs

Offset, expressed in millisecond, to add between the existing item and the new one that is going to be appended.

•	Set this parameter to a positive value when you need to add silence between the existing item and the new one that is going to be appended.

•	Set this parameter to 0 if no silence is needed.

•	Set this parameter to a negative value if you need the new added item to overlap the end of the existing item of the given amount of time.

Return value

Value	Meaning

Negative value	An error occurred (see the LastError property for further error details)
enumErrorCodes.NOERROR (0)	The method call was successful.