Series 300 Only

NAME

winput_widpath − get path name for a window id

SYNOPSIS

int winput_widpath(wmfd,wid,wname);
int wmfd;
int wid;
char *wname;

DESCRIPTION

wmfd
is an integer file descriptor for an opened window manager device interface. 

wid is the window id for a window as returned by either winput_setroute(3W) or winput_getroute(3W). Note that a window id is not the same as a window’s file descriptor. 

wname
is a pointer to a space to be filled with the path name of the window referred to by wid.  This string will be null-terminated and will not exceed 40 characters in length. 

DISCUSSION

This routine works only with graphics windows.  On return, the wname parameter points to the null-terminated path name of the window whose window id is wid.  To get the window id for a path name, see winput_getroute(3W).  A window’s window is is also returned by winput_setroute(3W).

HARDWARE DEPENDENCIES

Series 500:
Graphics window input routines (winput_∗) are not supported on Series 500; they work only on Series 300.

SEE ALSO

winput_getroute(3W), winput_read(3W), winput_setroute(3W). 

DIAGNOSTICS

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

Hewlett-Packard Company  —  May 11, 2021