Progress
Language Reference
LOAD-ICON( ) Method
Specifies the file that contains the icon that you want to load for display in the title bar of a window, in the task bar, and when selecting a program using ALT-TAB. This method can accommodate icons formatted as small size (16x16) icons, regular size (32x32) icons, or both.
An icon file might contain multiple icons. In those instances when multiple icons are in a file, this method uses the 32x32 icon, if one exists, from the file that you specified. However, if a 32x32 icon does not exist, it uses the first icon in the file.
You must use this method if you want a specific program icon to display when selecting a program using ALT-TAB.
If the load is successful, this method returns TRUE.
Return Type: LOGICAL Applies To: Window
icon-filename
A character-string expression that specifies a full or relative pathname for a file that contains the icon that you want to load for display in the title bar of a window, in the task bar, and when selecting a program using ALT-TAB.
n
An integer expression that specifies the position of the icon within the file. Only use this expression if you want to override the default behavior.
For example, LOAD-ICON(“file.ico”, 2) finds the second icon in the icon file
file.ico
and loads it. LOAD-ICON(“”) removes the previously loaded icon.NOTES
NOTE: URL pathnames cannot contain the percent symbol (- On Windows, you can specify a URL pathname. If you specify a fully-qualified URL, LOAD-ICON loads the icon 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-ICON method continues searching with the next PROPATH entry.- If you specify URL pathnames on the PROPATH and your application repeatedly uses the LOAD-ICON 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 icon files. Use this value to create a fully-qualified URL pathname for icon-filename and avoid repeated searches of the PROPATH.
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |