home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xtcreateselectionrequest.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  4.1 KB  |  133 lines
  1.  
  2.  
  3.  
  4. XtCreateSelectionRequest(3XtX)T FUNCTIOXNtSCreateSelectionRequest(3Xt)
  5.  
  6.  
  7. NNAAMMEE
  8.        XtCreateSelectionRequest, XtSendSelectionRequest,
  9.        XtCancelSelectionRequest - bundle multiple selection con-
  10.        version requests into a single request using MULTIPLE tar-
  11.        get
  12.  
  13. SSYYNNTTAAXX
  14.        void XtCreateSelectionRequest(_r_e_q_u_e_s_t_o_r, _s_e_l_e_c_t_i_o_n)
  15.          Widget _r_e_q_u_e_s_t_o_r;
  16.          Atom _s_e_l_e_c_t_i_o_n;
  17.  
  18.        void XtSendSelectionRequest(_r_e_q_u_e_s_t_o_r, _s_e_l_e_c_t_i_o_n, _t_i_m_e)
  19.          Widget _r_e_q_u_e_s_t_o_r;
  20.          Atom _s_e_l_e_c_t_i_o_n;
  21.          Time _t_i_m_e;
  22.  
  23.        void XtCancelSelectionRequest(_r_e_q_u_e_s_t_o_r, _s_e_l_e_c_t_i_o_n)
  24.          Widget _r_e_q_u_e_s_t_o_r;
  25.          Atom _s_e_l_e_c_t_i_o_n;
  26.  
  27. AARRGGUUMMEENNTTSS
  28.        _r_e_q_u_e_s_t_o_r Specifies the widget making the request. Must be
  29.          of class Core or a subclass thereof.
  30.  
  31.        _s_e_l_e_c_t_i_o_n Specifies the particular selection desired.
  32.  
  33.        _t_i_m_e     Specifies the timestamp to be used in making the
  34.          request.
  35.  
  36. DDEESSCCRRIIPPTTIIOONN
  37.        When _X_t_C_r_e_a_t_e_S_e_l_e_c_t_i_o_n_R_e_q_u_e_s_t is called, subsequent calls
  38.        to _X_t_G_e_t_S_e_l_e_c_t_i_o_n_V_a_l_u_e and _X_t_G_e_t_S_e_l_e_c_t_i_o_n_V_a_l_u_e_I_n_c_r_e_m_e_n_t_a_l
  39.        with the requestor and selection as specified to _X_t_C_r_e_a_t_e_-
  40.        _S_e_l_e_c_t_i_o_n_R_e_q_u_e_s_t will be bundled into a single selection
  41.        conversion request with multiple targets. The request is
  42.        actually initiated by calling _X_t_S_e_n_d_S_e_l_e_c_t_i_o_n_R_e_q_u_e_s_t.
  43.  
  44.        When _X_t_S_e_n_d_S_e_l_e_c_t_i_o_n_R_e_q_u_e_s_t is called with a value of
  45.        _r_e_q_u_e_s_t_o_r and _s_e_l_e_c_t_i_o_n matching a previous call to
  46.        _X_t_C_r_e_a_t_e_S_e_l_e_c_t_i_o_n_R_e_q_u_e_s_t, a selection conversion request
  47.        is actually sent to the selection owner.     If a single tar-
  48.        get request is queued, that request is made. If multiple
  49.        targets are queued they are bundled into a single request
  50.        with the target MULTIPLE using the specified timestamp. As
  51.        the conversions are made, the callbacks associated with
  52.        each _X_t_G_e_t_S_e_l_e_c_t_i_o_n_V_a_l_u_e and _X_t_G_e_t_S_e_l_e_c_t_i_o_n_V_a_l_u_e_I_n_c_r_e_m_e_n_-
  53.        _t_a_l are invoked in turn.
  54.  
  55.        Multi-threaded applications should lock the application
  56.        context before calling _X_t_C_r_e_a_t_e_S_e_l_e_c_t_i_o_n_R_e_q_u_e_s_t and
  57.        release the lock after calling _X_t_S_e_n_d_S_e_l_e_c_t_i_o_n_R_e_q_u_e_s_t to
  58.        ensure that the thread assembling the reqeuest is safe
  59.        from interference by another thread assembling a different
  60.        request naming the same widget and selection.
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XtCreateSelectionRequest(3XtX)T FUNCTIOXNtSCreateSelectionRequest(3Xt)
  71.  
  72.  
  73.        When _X_t_C_a_n_c_e_l_S_e_l_e_c_t_i_o_n_R_e_q_u_e_s_t is called, any requests
  74.        queued since the last call to _X_t_C_r_e_a_t_e_S_e_l_e_c_t_i_o_n_R_e_q_u_e_s_t are
  75.        cleaned up. Subsequent calls to _X_t_G_e_t_S_e_l_e_c_t_i_o_n_V_a_l_u_e,
  76.        _X_t_G_e_t_S_e_l_e_c_t_i_o_n_V_a_l_u_e_s, _X_t_G_e_t_S_e_l_e_c_t_i_o_n_V_a_l_u_e_I_n_c_r_e_m_e_n_t_a_l, and
  77.        _X_t_G_e_t_S_e_l_e_c_t_i_o_n_V_a_l_u_e_s_I_n_c_r_e_m_e_n_t_a_l will not be defered.
  78.  
  79. SSEEEE AALLSSOO
  80.        _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
  81.        _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  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.