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 OpenEdge Development: Internationalizing 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.