Copyright © 2006-2019 MultiMedia Soft

WaveformScroller.SetBackPictureFromFile method

Previous pageReturn to chapter overviewNext page

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]

Public Function SetBackPictureFromFile (

hWndWaveformScroller as IntPtr,

strPathname as String,

nMode as enumBitmapModes

) as enumErrorCodes


 

[C#]

public enumErrorCodes SetBackPictureFromFile (

IntPtr hWndWaveformScroller,

string strPathname,

enumBitmapModes nMode

);


 

[C++]

public: enumErrorCodes SetBackPictureFromFile (

IntPtr hWndWaveformScroller,

string strPathname,

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

enumErrorCodes.ERR_NOERROR (0)

The method call was successful.