Copyright © 2008-2023 MultiMedia Soft

TracksBoard.SetBackPictureFromHandle method

Previous pageReturn to chapter overviewNext page

Remarks

 

Sets a background picture from an existing bitmap handle.

 

For details about the use of the TracksBoard refer to the How to use the TracksBoard to visually compose songs tutorial.

For further details about methods of the TracksBoard refer to the TracksBoard object section.

 

 

Syntax

 

[Visual Basic]

control.TracksBoard.SetBackPictureFromHandle (

hBitmap as OLE_HANDLE,

nMode as enumBitmapModes

) as enumErrorCodes


 

[C++]

short control.TracksBoard.SetBackPictureFromHandle (

OLE_HANDLE hBitmap,

short nMode

);


 

 

 

Parameter

Description

 

 

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