Copyright © 2008-2023 MultiMedia Soft

SetLoadingMode method

Previous pageReturn to chapter overviewNext page

Remarks

 

Sets the loading mode which will determine where loaded sound data will be stored inside the current editing session. The current loading mode can be obtained through the GetLoadingMode method.

 

 

Syntax

 

[Visual Basic]

control.SetLoadingMode (

nMode as enumLoadingModes

) as enumErrorCodes


 

[C++]

short control.SetLoadingMode (

short nMode

);


 

 

Parameter

Description

 

 

nMode

Number representing the loading mode that will affect the behaviour of the next sound loading session through a call to LoadSound, LoadSoundFromRawFile, LoadSoundFromMemory, LoadSoundFromRawMemory, LoadSoundFromClipboard or LoadSoundFromRecordingSession methods.

Supported values are the following:

Mnemonic constant

Value

Meaning

LOAD_MODE_NEW (Default)

0

Creates a fresh new editing session.

LOAD_MODE_APPEND

1

Appends the new loaded sound to the current editing session.

LOAD_MODE_MIX

2

Mixes the new loaded sound at a given position of the current editing session. You can set the exact mixing position and involved range through a call to the SetMixingPos method: if you won't define a mixing position, the new recording session will be mixed starting from the beginning of the current editing session.

LOAD_MODE_INSERT

3

Inserts the new loaded sound at a given position of the previous one. You can set the exact insert position through a call to the SetInsertPos method: if you don't define an insertion position, the new loaded sound will be inserted on the beginning of the current editing session.

LOAD_MODE_OVERWRITE

4

Uses the new loaded sound to overwrite the editing session contents at a given position. You can set the exact overwrite position and involved range through a call to the SetOverwritePos method: if you don't define an overwrite position, the new loaded sound will start overwriting contents at the beginning of the current editing session.

 

 

Return value

 

Value

Meaning

 

 

Negative value

An error occurred, check the LastError property value in order to see the error code meaning

enumErrorCodes.ERR_NOERROR (0)

The method call was successful.