WoSetToolIcon Procedure
Assigns a pixmap to be the icon for a VDA Tool.
Usage
WoSetToolIcon, tool_name, icon
Input Parameters
tool_name — The name of the VDA Tool for which to set the icon.
icon — The filename of the icon pixmap.
Keywords
Appdir — A string that specifies the application directory name. This is the directory in which the application searches for resource files, string resource files, and icon files. See the Discussion. (Default: vdatools)
Discussion
When a VDA Tool is iconized (the user clicks on the appropriate Window Manager button), the specified pixmap is shown on the icon.
By default, the function looks for file first in directories specified by the environment variable WAVE_RESPATH. This environment variable is a colon separated list of directories, similar to the PV‑WAVE WAVE_PATH environment variable. If not found in a WAVE_RESPATH directory, the directory $WAVE_DIR/xres/!Lang/vdatools is searched, where !Lang represents the value of the !Lang system variable in PV‑WAVE.
If Appdir is specified, the application searches for resources in the following directory:
(UNIX) <wavedir>/xres/!Lang/appdir
(WIN) <wavedir>\xres\!Lang\appdir
Where <wavedir> is the main PV‑WAVE directory.
Example
This call is taken from the code for the WzContour VDA Tool. It sets the icon pixmap for WzContour.
...
WoSetToolIcon, top, 'wzcontour.pm'
...
