XtAddInput() XtAddInput()
Name
XtAddInput - register a procedure to be called when there is activity on a file descriptor.
Synopsis
XtInputId XtAddInput(source, condition, proc, client_data)
int source;
XtPointer condition;
XtInputCallbackProc proc;
XtPointer client_data;
Inputs
source Specifies the file descriptor (on a POSIX-based system) to monitor.
condition Specifies a mask that indicates a read, write, or exception condition or some operating-system-dependent condition.
proc Specifies the procedure that is to be called when condition occurs on source.
client_data
Specifies data to be passed to proc when it is invoked.
Returns
A handle of type XtInputId that can be passed to XtRemoveInput() to unregister this input procedure.
Availability
Superseded by XtAppAddInput().
Description
XtAddInput() registers a file descriptor source to be monitored by XtAppNextEvent() and a procedure proc to be called with data client_data
when the condition (such as "input ready" or "error") condition arises.
On a POSIX-based system, the supported values for condition are XtInputReadMask, XtInputWriteMask, or XtInputExceptMask. These values can-
not be ORed together.
Usage
XtAddInput() has been superseded by XtAppAddInput(), which performs the same function on a per-application context basis. XtAddInput() now
calls XtAppAddInput() passing the default application context created by XtInitialize(). Very few programs need multiple application con-
texts, and you can continue to use XtAddInput() if you initialize your application with XtInitialize(). We recommend, however, that you
use XtAppInitialize(), XtAppAddInput(), and the other XtApp*() application context specific functions.
See XtAppAddInput() for more information.
See Also
XtAppAddInput(1), XtRemoveInput(1),
XtInputCallbackProc(2).
Xt - Event Handling XtAddInput()