Remarks
Sets a background picture from an existing bitmap handle.
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.SetBackPictureFromHandle (
hWndWaveformScroller as OLE_HANDLE,
hBitmap as OLE_HANDLE,
nMode as enumBitmapModes
) as enumErrorCodes
|
|
[C++]
short control.WaveformScroller.SetBackPictureFromHandle (
OLE_HANDLE hWndWaveformScroller,
OLE_HANDLE hBitmap,
short nMode
);
|
|
Parameter
|
Description
|
|
|
hWndWaveformScroller
|
Handle of the control returned by a previous call to the WaveformScroller.Create method
|
hBitmap
|
Handle (HBITMAP) of the bitmap to apply. If this parameter is set to 0 an eventual picture set through a previous call to this method will be reset.
|
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
|
|
