Copyright © 2008-2018 MultiMedia Soft

WaveformScroller.SetBackPictureFromHandle method

Previous pageReturn to chapter overviewNext page

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