IMAGE

DIALOG ADD, IMAGE,<name>,<top>,<left>,<width>,<height>,<filename>,<tooltip>,<styles>

This dialog element displays an image file. It can optionally use a transition effect when replacing one image file by another. It supports most formats of the following file types: BMP, EMF, GIF, JPG, PCX, PNG, TIF, WMF. GIF transparency and animation are not supported by this dialog element.

The bitmap image can be loaded directly from a file, a URL or a resource compiled in to the executable file. In this case, the file should be located in the project folder or the resource folder specified in the project options, and the filename should be prefixed by a hash '#' character.

If the width or height are omitted then the dialog element automatically resizes itself to fit the image.

The IMAGE dialog element is an external dialog element. The VDSIMGxx extension must be loaded by the program, and packaged with all compiled executable files. The external command IMAGE and function @IMAGE may be required to use all of the functionality of the element.

In addition to user-defined styles to change the default font style and color, the following styles may be used with this dialog element:

CENTER	The image is displayed at its normal size, centered in the dialog element.
CLICK	The element will generate a <name>CLICK event when the image is clicked with the mouse. You can test whereabouts on the bitmap the mouse was clicked and which button was used with the @CLICK function.
RESIZE	The image is stretched so that it fills the dialog element horizontally or vertically, but the aspect ratio is maintained correctly.
STRETCH	The image is stretched to fit the dimensions of the dialog element.
<cursor style>	The cursor will change to the named style when the pointer is over the dialog element. Valid styles are: NONE, ARROW, CROSS, IBEAM, SIZE, NESW, NS, NWSE, WE, UP, WAIT, DRAG, NODROP, HSPLIT, VSPLIT, MULTI, SQL, NO, HELP, HAND.

IMAGE dialog element [VDS6]
Top Previous Next