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