Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Thursday, June 13, 2019
 
 

tttk_Xt_input_handler (3)

Name

tttk_Xt_input_handler - Process ToolTalk events for Xt clients

Synopsis

#include <Tt/tttk.h>
void tttk_Xt_input_handler(XtPointer procid,
int *source,
XtInputId *id);

Description

tttk_Xt_input_handler(3)      ToolTalk Functions      tttk_Xt_input_handler(3)



NAME
       tttk_Xt_input_handler - Process ToolTalk events for Xt clients

SYNOPSIS
       #include <Tt/tttk.h>
       void tttk_Xt_input_handler(XtPointer procid,
                                  int *source,
                                  XtInputId *id);

DESCRIPTION
       If   procid   is   not   NULL,  tttk_Xt_input_handler()  passes  it  to
       tt_default_procid_set(3).  The  tttk_Xt_input_handler()  function  then
       calls  tt_message_receive(3),  which  retrieves the next message avail-
       able, if any, for the default procid.  If tt_message_receive(3) returns
       TT_ERR_NOMP,  then  tttk_Xt_input_handler()  closes  the default procid
       with ttdt_close(3), and removes the input source *id  with  XtRemoveIn-
       put(3X)  if  id  is  not  zero.   If a message is available and tt_mes-
       sage_receive(3) returns it (indicating it was not consumed by any  mes-
       sage or pattern callback), then the ToolTalk service passes the message
       to tttk_message_abandon(3).

RETURN VALUE
       The tttk_Xt_input_handler() function returns no value.

APPLICATION USAGE
       The application should use tttk_Xt_input_handler() as its Xt input han-
       dler unless some messages are expected not to be consumed by callbacks.
       (The only messages that absolutely cannot be intercepted  and  consumed
       by  callbacks  are  those  that  match observe signatures in a ptype or
       otype.)

EXAMPLES
       int myTtFd;
       char *myProcID;
       myProcID = ttdt_open(&myTtFd, "WhizzyCalc", "Acme", "1.0", 1);
       /* ... */
       /* Process the message that started us, if any */
       tttk_Xt_input_handler(myProcID, 0, 0);
       /* ... */
       XtAppAddInput(myContext, myTtFd, (XtPointer)XtInputReadMask,
               tttk_Xt_input_handler, myProcID);

ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | library/tooltalk |
       +---------------+------------------+
       |Stability      | Committed        |
       +---------------+------------------+
SEE ALSO
       tttk(5), ttdt_close(3), tttk_message_abandon(3), tt_default_pro-
       cid_set(3), tt_message_receive(3), XtAppAddInput(3X), XtRemoveIn-
       put(3X).




ToolTalk 1.3                     1 March 1996         tttk_Xt_input_handler(3)