WDFLTPOS(3W)

NAME

wdfltpos − default window/icon position

SYNOPSIS

int wdfltpos(fd,req,wx,wy,ix,iy,name);
int fd;
int req;
int *wx,*wy;
int *ix,*iy;
char *name;

DESCRIPTION

fd is an integer file descriptor of an opened window manager or window type device interface.

req determines which values are returned by this routine; values are specified by setting the appropriate bits in this parameter. Bits are defined as follows:

bit 1 return wx, wy

bit 2 return iconx, icony

bit 3 return name[16]

wx,wy
are pointers to the default position of a window.

ix,iy are pointers to the default position of an icon.

name
is a pointer to a 16-character space in which a window system default name is returned. This name is only the basename (see basename(1)).

DISCUSSION

This routine returns a round robin default position for a window or icon. Windows stair step down from the upper left corner of the screen. Icons go down from the upper right or up from the lower left, depending on the icon placement parameter given to the window manager at powerup.

Note: wdfltpos assigns values to only the requested parameters; therefore, dummy space need not be declared for the name parameter.

DIAGNOSTICS

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