(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
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.
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.