home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / Xt / XtCreateSelectionRequest.z / XtCreateSelectionRequest
Encoding:
Text File  |  2002-10-03  |  5.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXttttCCCCrrrreeeeaaaatttteeeeSSSSeeeelllleeeeccccttttiiiioooonnnnRRRReeeeqqqquuuueeeesssstttt((((3333XXXXtttt))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))XXXXttttCCCCrrrreeeeaaaatttteeeeSSSSeeeelllleeeeccccttttiiiioooonnnnRRRReeeeqqqquuuueeeesssstttt((((3333XXXXtttt))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XtCreateSelectionRequest, XtSendSelectionRequest,
  10.           XtCancelSelectionRequest - bundle multiple selection
  11.           conversion requests into a single request using MULTIPLE
  12.           target
  13.  
  14.      SSSSYYYYNNNNTTTTAAAAXXXX
  15.           void XtCreateSelectionRequest(_r_e_q_u_e_s_t_o_r, _s_e_l_e_c_t_i_o_n)
  16.                 Widget _r_e_q_u_e_s_t_o_r;
  17.                 Atom _s_e_l_e_c_t_i_o_n;
  18.  
  19.           void XtSendSelectionRequest(_r_e_q_u_e_s_t_o_r, _s_e_l_e_c_t_i_o_n, _t_i_m_e)
  20.                 Widget _r_e_q_u_e_s_t_o_r;
  21.                 Atom _s_e_l_e_c_t_i_o_n;
  22.                 Time _t_i_m_e;
  23.  
  24.           void XtCancelSelectionRequest(_r_e_q_u_e_s_t_o_r, _s_e_l_e_c_t_i_o_n)
  25.                 Widget _r_e_q_u_e_s_t_o_r;
  26.                 Atom _s_e_l_e_c_t_i_o_n;
  27.  
  28.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  29.           _r_e_q_u_e_s_t_o_r Specifies the widget making the request. Must be
  30.                     of class Core or a subclass thereof.
  31.  
  32.           _s_e_l_e_c_t_i_o_n Specifies the particular selection desired.
  33.  
  34.           _t_i_m_e      Specifies the timestamp to be used in making the
  35.                     request.
  36.  
  37.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  38.           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 to
  39.           _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 with
  40.           the requestor and selection as specified to
  41.           _X_t_C_r_e_a_t_e_S_e_l_e_c_t_i_o_n_R_e_q_u_e_s_t will be bundled into a single
  42.           selection conversion request with multiple targets. The
  43.           request is actually initiated by calling
  44.           _X_t_S_e_n_d_S_e_l_e_c_t_i_o_n_R_e_q_u_e_s_t.
  45.  
  46.           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
  47.           _r_e_q_u_e_s_t_o_r and _s_e_l_e_c_t_i_o_n matching a previous call to
  48.           _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 is
  49.           actually sent to the selection owner.  If a single target
  50.           request is queued, that request is made. If multiple targets
  51.           are queued they are bundled into a single request with the
  52.           target MULTIPLE using the specified timestamp. As the
  53.           conversions are made, the callbacks associated with each
  54.           _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 are
  55.           invoked in turn.
  56.  
  57.           Multi-threaded applications should lock the application
  58.           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 release
  59.           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 ensure that
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXttttCCCCrrrreeeeaaaatttteeeeSSSSeeeelllleeeeccccttttiiiioooonnnnRRRReeeeqqqquuuueeeesssstttt((((3333XXXXtttt))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))XXXXttttCCCCrrrreeeeaaaatttteeeeSSSSeeeelllleeeeccccttttiiiioooonnnnRRRReeeeqqqquuuueeeesssstttt((((3333XXXXtttt))))
  71.  
  72.  
  73.  
  74.           the thread assembling the reqeuest is safe from interference
  75.           by another thread assembling a different request naming the
  76.           same widget and selection.
  77.  
  78.           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 queued
  79.           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 cleaned
  80.           up. Subsequent calls to _X_t_G_e_t_S_e_l_e_c_t_i_o_n_V_a_l_u_e,
  81.           _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
  82.           _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.
  83.  
  84.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  85.           _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
  86.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  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.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.