(Windows only; Graphical interfaces only)

Reads the image contained in a specified file. The image is used for the button in its down state only.

Return type: LOGICAL

Applies to: BUTTON widget

Syntax

LOAD-IMAGE-DOWN ( filename[ , x-offset , y-offset , width , height ] )
filename
A character-string expression that specifies a full or relative pathname for a file that contains an image to display in a button when the button is in its down state.
x-offset
An integer expression that specifies the pixel along the x-axis at which to begin reading from the image file.
y-offset
An integer expression that specifies the pixel along the y-axis at which to begin reading from the image file.
width
An integer expression that specifies the number of pixels along the x-axis to read from the image file.
height
An integer expression that specifies the number of pixels along the y-axis to read from the image file.

The image is not displayed until the widget is realized. If the read is successful, the method returns TRUE.

In Windows, you can specify a URL pathname. If you specify a fully-qualified URL, LOAD-IMAGE-DOWN( ) loads the image file directly without searching directories or URLs in PROPATH. Valid URL protocols include HTTP and HTTPS.

Note: URL pathnames cannot contain the percent symbol (%). If an error exists in a URL specified on the PROPATH, the LOAD-IMAGE-DOWN( ) method continues searching with the next PROPATH entry.

If you specify URL pathnames on the PROPATH and your application repeatedly uses the LOAD-IMAGE-DOWN( ) method with a URL pathname, you can improve performance by using the SEARCH function once to determine the full URL pathname to the directory containing the image files. Use this value to create a fully-qualified URL pathname for filename and avoid repeated searches of the PROPATH.