Remarks
Sets a background picture from a graphic file.
For further details about methods of the Waveform scroller refer to the WaveformScroller object.
For a tutorial about the use of Waveform scrollers refer to the How to scroll the sound's waveform during playback tutorial.
Syntax
[Visual Basic]
control.WaveformScroller.SetBackPictureFromFile (
hWndWaveformScroller as OLE_HANDLE,
strPathname as String,
nMode as enumBitmapModes
) as enumErrorCodes
|
|
[C++]
short control.WaveformScroller.SetBackPictureFromFile (
OLE_HANDLE hWndWaveformScroller,
LPCTSTR strPathname,
short nMode
);
|
|
Parameter
|
Description
|
|
|
hWndWaveformScroller
|
Handle of the control returned by a previous call to the WaveformScroller.Create method
|
strPathname
|
Absolute pathname of the picture file to load. Accepted graphic formats are BMP, JPEG, GIF, TIFF and PNG.
An empty pathname will reset an eventual picture set through a previous call to this method.
|
nMode
|
Bitmap mode.
Supported values are the following:
Mnemonic constant
|
Value
|
Meaning
|
BITMAP_MODE_TOP_LEFT
|
0
|
Bitmap will be drawn in top-left position on the destination rectangle
|
BITMAP_MODE_CENTER
|
1
|
Bitmap will be drawn in centered position on the destination rectangle
|
BITMAP_MODE_STRETCH
|
2
|
Bitmap will be stretched in order to fit the destination rectangle
|
BITMAP_MODE_TILE
|
3
|
Bitmap will be tiled in order to fill the destination rectangle
|
|
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
|
|
