XtAddInput(3x) — HPUX 9.05

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

sourceSpecifies the file descriptor (on a POSIX-based system) to monitor.

conditionSpecifies a mask that indicates a read, write, or exception condition or some operating-system-dependent condition.

procSpecifies 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 cannot 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 contexts, 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.

Museum

Related Articles