Progress
Language Reference
LOAD-IMAGE-INSENSITIVE( ) Method
Reads the image contained in specified file. The image is used for the button in its insensitive state.
Return Type: LOGICAL Applies To: Button
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 insensitive.
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.
NOTES
- If this image is not loaded, the appearance of the button up image does not change between the button’s sensitive and insensitive state; if no image is loaded, the button label is grayed out in its insensitive state.
- The image is not displayed until the widget is realized. If the read is successful, the method returns TRUE.
NOTE: URL pathnames cannot contain the percent symbol (- On Windows, you can specify a URL pathname. If you specify a fully-qualified URL, LOAD-IMAGE-INSENSITIVE loads the image file directly without searching directories or URLs in PROPATH. Valid URL protocols include HTTP and HTTPS.
%
). If an error exists in a URL specified on the PROPATH, the LOAD-IMAGE-INSENSITIVE method continues searching with the next PROPATH entry.- If you specify URL pathnames on the PROPATH and your application repeatedly uses the LOAD-IMAGE-INSENSITIVE 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.
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |