Series 300 and 500 Only

NAME

wseticon − set icon

SYNOPSIS

#include <fonticon.h>
int wseticon(fd,imode,lmode,iconfile);
int fd;
int imode,lmode;
char *iconfile;

DESCRIPTION

fd is an integer file descriptor for an opened window type device interface. 

imode
is the mode controlling which parts of the icon are displayed; following are valid values for this paramter:

0 then do not display the picture portion of the icon. 

1 display the type-dependent picture for the icon. 

2 display the icon picture referenced by iconfile. 

lmode
is the mode controlling the display choice of the label:

0 do not display a label. 

1 display the label last specified by wsetlabel. 

iconfile
is the full path name of an icon file. See the iconstruct definition in /usr/include/fonticon.h. 

DISCUSSION

wseticon sets the iconic representation for the window.  The default at creation depends upon the window type.  The foreground and background colors are the same as the window border colors. 

Note that imode and lmode cannot both equal 0. 

SEE ALSO

wiconic(3W),wseticonpos(3W),wgeticonpos(3W),wsetlabel(3W). 

DIAGNOSTIC

A return of -1 indicates failure; otherwise 0 is returned.  See errno(2) for more information.

Hewlett-Packard Company  —  May 11, 2021