NAME

winput_getroute − determine window input routing path

SYNOPSIS

int winput_getroute(fd,routepath);
int fd;
char *routepath;

DESCRIPTION

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

routepath
is a pointer to a space to be filled with the null-terminated path name of the window type device interface currently receiving all input and events that would normally go to the window represented by fd.  The path name string cannot exceed 40 characters in length. 

DISCUSSION

This routine determines whether any input or event routing is being done for the window referenced by fd (see winput_setroute(3W)). If input routing is enabled for the window, then routepath will point to the path name of the window receiving this input.  Otherwise routepath will point to a null (zero-length) string. 

In a multi-hop route, this routine will return the path name of the immediate window to which its input is routed, not necessarily the final destination. 

HARDWARE DEPENDENCIES

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

SEE ALSO

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

DIAGNOSTICS

A return value of -1 indicates failure; see errno(2) for more information. Otherwise, the window id, wid, of the window referenced by fd is returned. 

Hewlett-Packard Company  —  HP-UX Release 8.0: January 1991