@BITMAP   [VDS6]

Top  Previous  Next

Syntax:

 

@BITMAP(<element name>, DEPTH)

@BITMAP( <element name>, PIXEL, <x>, <y>)

@BITMAP(<element name>, SIZE)

@BITMAP(<element name>, TEXTSIZE, <text>, <font name>, <font size>, <font attributes>)

 

Description:

 

This function returns information about the bitmap image displayed in the BITMAP dialog element <element name>. The options are:

DEPTH

Returns the color depth, or number of bits per pixel, of the bitmap.

PIXEL

Returns the color of the pixel at co-ordinate <x>, <y> of the bitmap.

SIZE

Returns the width and height of the bitmap. The size is returned as two numbers separated by the  current field separator character. These values are not the same as the width and height obtained using the @DLGPOS function, which returns the size of the dialog element itself not that of the bitmap.

TEXTSIZE

Returns the width and height of the text <text> when drawn on the bitmap using the specified font, size and attributes. The font characteristics are specified in the same way as for a STYLE dialog element. Where the values are omitted, the defaults or last-used values are used. The size is returned as two numbers separated by the current field separator character.

Note: Bitmap information is only available when the BITMAP dialog element is displaying a bitmap, not an icon (.ico) file.

 

OK:

 

Set to false if the information is unavailable.

 

See also: