PictureCustom property

Remarks

The pathname or HTTP URL of the picture file used to render the shape of the button.

Applies only when the Shape property is set to SHAPE_CUSTOM (5).

Supported bitmap fornats are BMP, GIF, or PNG.

If the filename is an HTTP URL it is possible to use the proprietary compressed format AMZ.

If you need to download the file from an FTP URL it is possible to use the abmSetPictureFromNet function.

The example below shows how a black & white picture can be used as a mask for a button that will have the same shape of the white part of the picture.

NOTE: from version 2 of the SDK you can use also color pictures and not only black & white pictures: this is very useful for implementing custom 3D rendering of the control surface.

Get / Set functions

BSTR abmGetPictureCustom (

HWND hWndBtn

);

void abmSetPictureCustom (

HWND hWndBtn,

LPCTSTR strFilename

);

Parameters	Description
hWndBtn	Windows handle associated to the button.
strFilename	String containing the picture pathname.

Notes

If using the abmGetPictureCustom function from within Visual Basic 6, remember to convert the returned value from UNICODE using the StrConv function and its related vbFromUnicode option, as in the sample below:

MsgBox StrConv(abmGetPictureCustom(Command1.hwnd), vbFromUnicode)