home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xtgetselectionvalues.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  3.8 KB  |  133 lines
  1.  
  2.  
  3.  
  4. XtGetSelectionValue(3Xt)   XT FUNCTIONS     XtGetSelectionValue(3Xt)
  5.  
  6.  
  7. NNAAMMEE
  8.        XtGetSelectionValue, XtGetSelectionValues - obtain selec-
  9.        tion values
  10.  
  11. SSYYNNTTAAXX
  12.        void XtGetSelectionValue(_w, _s_e_l_e_c_t_i_o_n, _t_a_r_g_e_t, _c_a_l_l_b_a_c_k,
  13.        _c_l_i_e_n_t___d_a_t_a, _t_i_m_e)
  14.          Widget _w;
  15.          Atom _s_e_l_e_c_t_i_o_n;
  16.          Atom _t_a_r_g_e_t;
  17.          XtSelectionCallbackProc _c_a_l_l_b_a_c_k;
  18.          XtPointer _c_l_i_e_n_t___d_a_t_a;
  19.          Time _t_i_m_e;
  20.  
  21.        void XtGetSelectionValues(_w, _s_e_l_e_c_t_i_o_n, _t_a_r_g_e_t_s, _c_o_u_n_t,
  22.        _c_a_l_l_b_a_c_k, _c_l_i_e_n_t___d_a_t_a, _t_i_m_e)
  23.          Widget _w;
  24.          Atom _s_e_l_e_c_t_i_o_n;
  25.          Atom *_t_a_r_g_e_t_s;
  26.          int _c_o_u_n_t;
  27.          XtSelectionCallbackProc _c_a_l_l_b_a_c_k;
  28.          XtPointer _c_l_i_e_n_t___d_a_t_a;
  29.          Time _t_i_m_e;
  30.  
  31. AARRGGUUMMEENNTTSS
  32.        _c_a_l_l_b_a_c_k     Specifies the callback procedure that is to be
  33.          called when the selection value has been
  34.          obtained.
  35.  
  36.        _c_l_i_e_n_t___d_a_t_a
  37.          Specifies the argument that is to be passed to
  38.          the specified procedure when it is called.
  39.  
  40.        _c_l_i_e_n_t___d_a_t_a
  41.          Specifies the client data (one for each target
  42.          type) that is passed to the callback procedure
  43.          when it is called for that target.
  44.  
  45.        _c_o_u_n_t     Specifies the length of the targets and
  46.          client_data lists.
  47.  
  48.        _s_e_l_e_c_t_i_o_n Specifies the particular selection desired (that
  49.          is, primary or secondary).
  50.  
  51.        _t_a_r_g_e_t     Specifies the type of the information that is
  52.          needed about the selection.
  53.  
  54.        _t_a_r_g_e_t_s     Specifies the types of information that is
  55.          needed about the selection.
  56.  
  57.        _t_i_m_e     Specifies the timestamp that indicates when the
  58.          selection value is desired.
  59.  
  60.        _w     Specifies the widget that is making the request.
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XtGetSelectionValue(3Xt)   XT FUNCTIONS     XtGetSelectionValue(3Xt)
  71.  
  72.  
  73. DDEESSCCRRIIPPTTIIOONN
  74.        The _X_t_G_e_t_S_e_l_e_c_t_i_o_n_V_a_l_u_e function requests the value of the
  75.        selection that has been converted to the target type.  The
  76.        specified callback will be called some time after _X_t_G_e_t_-
  77.        _S_e_l_e_c_t_i_o_n_V_a_l_u_e is called; in fact, it may be called before
  78.        or after _X_t_G_e_t_S_e_l_e_c_t_i_o_n_V_a_l_u_e returns.
  79.  
  80.        The _X_t_G_e_t_S_e_l_e_c_t_i_o_n_V_a_l_u_e_s function is similar to _X_t_G_e_t_-
  81.        _S_e_l_e_c_t_i_o_n_V_a_l_u_e except that it takes a list of target types
  82.        and a list of client data and obtains the current value of
  83.        the selection converted to each of the targets.    The
  84.        effect is as if each target were specified in a separate
  85.        call to _X_t_G_e_t_S_e_l_e_c_t_i_o_n_V_a_l_u_e.  The callback is called once
  86.        with the corresponding client data for each target.
  87.        _X_t_G_e_t_S_e_l_e_c_t_i_o_n_V_a_l_u_e_s does guarantee that all the conver-
  88.        sions will use the same selection value because the owner-
  89.        ship of the selection cannot change in the middle of the
  90.        list, as would be when calling _X_t_G_e_t_S_e_l_e_c_t_i_o_n_V_a_l_u_e repeat-
  91.        edly.
  92.  
  93. SSEEEE AALLSSOO
  94.        XtAppGetSelectionTimeout(3Xt), XtOwnSelection(3Xt)
  95.        _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
  96.        _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  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.