home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xtappaddsignal.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  3.1 KB  |  133 lines
  1.  
  2.  
  3.  
  4. XtAppAddSignal(3Xt)       XT FUNCTIONS          XtAppAddSignal(3Xt)
  5.  
  6.  
  7. NNAAMMEE
  8.        XtAppAddSignal, XtRemoveSignal, XtNoticeSignal - register
  9.        and remove a signal source
  10.  
  11. SSYYNNTTAAXX
  12.        XtSignalId XtAppAddSignal(_a_p_p___c_o_n_t_e_x_t, _p_r_o_c, _c_l_i_e_n_t___d_a_t_a)
  13.          XtAppContext _a_p_p___c_o_n_t_e_x_t;
  14.          XtInputCallbackProc _p_r_o_c;
  15.          XtPointer _c_l_i_e_n_t___d_a_t_a;
  16.  
  17.        void XtRemoveSignal(_i_d)
  18.          XtSignalId _i_d;
  19.  
  20.        void XtNoticeSignal(_i_d)
  21.          XtSignalId _i_d)
  22.  
  23. AARRGGUUMMEENNTTSS
  24.        _a_p_p___c_o_n_t_e_x_t
  25.          Specifies the application context.
  26.  
  27.        _c_l_i_e_n_t___d_a_t_a
  28.          Specifies the argument that is to be passed to
  29.          the specified procedure when a signal has been
  30.          raised.
  31.  
  32.        _i_d     Specifies the ID returned from the corresponding
  33.          _X_t_A_p_p_A_d_d_S_i_g_n_a_l call.
  34.  
  35.        _p_r_o_c     Specifies the procedure that is to be called
  36.          when the signal has been raised.
  37.  
  38. DDEESSCCRRIIPPTTIIOONN
  39.        The _X_t_A_p_p_A_d_d_S_i_g_n_a_l function initiates a mechanism for han-
  40.        dling signals within the context of the Intrinsics. Prior
  41.        to establishing an operating system dependent signal han-
  42.        dler the application may call _X_t_A_p_p_A_d_d_S_i_g_n_a_l and store the
  43.        returned _i_d in a place accessible to the signal handler.
  44.  
  45.        Upon receipt of a signal from the operating system, the
  46.        application may call _X_t_N_o_t_i_c_e_S_i_g_n_a_l passing the _i_d
  47.        returned by the call to _X_t_A_p_p_A_d_d_S_i_g_n_a_l.
  48.  
  49.        _X_t_N_o_t_i_c_e_S_i_g_n_a_l is the only Intrinsics function that can
  50.        safely be called from a signal handler. If _X_t_N_o_t_i_c_e_S_i_g_n_a_l
  51.        is called multiple times before the Intrinsics are able to
  52.        invoke the registered callback, the callback is only
  53.        called once. Logically the Intrinsics maintain ``pending''
  54.        for each registered callback. This flag is initially _F_a_l_s_e
  55.        and is set to _T_r_u_e by _X_t_N_o_t_i_c_e_S_i_g_n_a_l; the Intrinsics
  56.        invoke the callback whenever the flag is _T_r_u_e, and the
  57.        flag is set to _F_a_l_s_e just before the callback is invoked.
  58.  
  59.        The _X_t_R_e_m_o_v_e_S_i_g_n_a_l function is called to remove the speci-
  60.        fied Intrinsics signal handler. The client should disable
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XtAppAddSignal(3Xt)       XT FUNCTIONS          XtAppAddSignal(3Xt)
  71.  
  72.  
  73.        the source of the signal before calling _X_t_R_e_m_o_v_e_S_i_g_n_a_l.
  74.  
  75. SSEEEE AALLSSOO
  76.        XtAppAddTime-
  77.        Out(3Xt),XtAppAddInput(3Xt),XtAppAddWorkProc(3Xt)
  78.        _X _T_o_o_l_k_i_t _I_n_t_r_i_n_s_i_c_s _- _C _L_a_n_g_u_a_g_e _I_n_t_e_r_f_a_c_e
  79.        _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.