AppendAutomationItemAddFromEditor method |
|
Remarks
Adds contents of an editing session belonging to another instance of the Active Sound Editor control to the append automation list.
For further information about management of append automation sessions refer to the How to mix or append several sounds in one single shot tutorial.
Syntax
[Visual Basic] control.AppendAutomationItemAddFromEditor ( hWndEditorCtrl as OLE_HANDLE nStartPosition as Long, nEndPosition as Long, fVolume as Single ) as enumErrorCodes |
[C++] short control.AppendAutomationItemAddFromEditor ( OLE_HANDLE hWndEditorCtrl, long nStartPosition, long nEndPosition, float fVolume ); |
Parameter |
Description |
|
|
hWndEditorCtrl |
Window handle to the other instance of the Active Sound Editor control |
nStartPosition |
Start position, expressed in milliseconds, of the range to load from the added editing session |
nEndPosition |
End position, expressed in milliseconds, of the range to load from the added editing session |
fVolume |
Volume level applied to the added song when it will be appended. Supported values are expressed with a linear volume in the range from 0 to 100. In case you should need to set a volume expressed in dB, before setting this parameter you could convert the value in dB into a linear value through the following formula (C syntax): VolumeLinear = 100 * pow (10, VolumeInDB/20); |
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. |