Release 10.1A: OpenEdge Development:
Progress 4GL 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 widget

> Syntax
>     LOAD-ICON ( icon-filename [ , n ] )

> ``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

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

> Note: URL pathnames cannot contain the percent symbol (%). 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 © 2005 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095