Copyright © 2011-2019 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]

Public Function SetBackPictureFromHandle (

hWndWaveformScroller as IntPtr,

hBitmap as IntPtr,

nMode as enumBitmapModes

) as enumErrorCodes


 

[C#]

public enumErrorCodes SetBackPictureFromHandle (

IntPtr hWndWaveformScroller,

IntPtr hBitmap,

enumBitmapModes nMode

);


 

[C++]

public: enumErrorCodes SetBackPictureFromHandle (

IntPtr hWndWaveformScroller,

IntPtr hBitmap,

enumBitmapModes 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 (see the LastError property for further error details)

enumErrorCodes.ERR_NOERROR (0)

The method call was successful.