LOAD-PICTURE statement

(Windows only; Graphical interfaces only)

Returns a COM-HANDLE to an OlePictureObject. You can use this COM-HANDLE to set graphical properties of controls.

Note: Does not apply to SpeedScript programming.

Syntax

LOAD-PICTURE [ image ]

image: A CHARACTER expression representing the name of the graphical file. This file can have one of the following extensions: .BMP, .EMF, .ICO, .CUR, .DIB. If the filename is not fully qualified, LOAD-PICTURE searches for a matching file on the user's path. The filename can contain Unicode characters. See Internationalize ABL Applications for more information about Unicode.

Example

The following program fragment illustrates the use of the LOAD-PICTURE statement:

DEFINE VARIABLE chPic     AS COM-HANDLE NO-UNDO.
DEFINE VARIABLE chControl AS COM-HANDLE NO-UNDO.

/* Get the COM-HANDLE of an Image control */

/* Use LOAD-PICTURE to get a COM-HANDLE to the bitmap contained in myPic.bmp */
chPic = LOAD-PICTURE("myPic.bmp").

/* Set the control's Picture property for the bitmap */
chControl:Picture = chPic.