DESIGN (xvwidgets) functions


LIBRARY ROUTINE

xvw_add_detectfid - add (fid) input handler to an object

LIBRARY CALL

void xvw_add_detectfid(
   xvobject   object,
   int        fid,
   void       (*routine)(xvobject, int, kaddr),
   kaddr      client_data)

INPUT

OUTPUT

none

RETURN VALUE

none

DESCRIPTION

Causes a detection mechanism to be installed on the specified file descriptor; the file descriptor will be polled intermittently for change (input or output). If a change in the file descriptor is detected, then the specified input handler is called.

The input handler can be associated with an object, so that fid detection is automatically discontinued when the object is destroyed. If NULL is passed for the object, then the input handler is added to the global file detection list.

The detect file callback must be declared in the following form: int input_handler( xvobject object, int fid, kaddr client_data)

object - If xvw_add_detectfid() is called with a particular xvobject, that object will be passed into the input handle r.

fid - This is the file descriptor being monitored for change.

client_data - The pointer to the client data, used to pass parameters from the application to the input handler.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

$DESIGN/objects/library/xvwidgets/src/fid.c

SEE ALSO

xvwidgets(3)

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.