home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xtsetselectionparameters.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  3.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4. XtSetSelectionParameters(3XtX)T FUNCTIOXNtSSetSelectionParameters(3Xt)
  5.  
  6.  
  7. NNAAMMEE
  8.        XtSetSelectionParameters - specify target parameters for a
  9.        selection request with a single target
  10.  
  11. SSYYNNTTAAXX
  12.        void XtSetSelectionParameters(_r_e_q_u_e_s_t_o_r, _s_e_l_e_c_t_i_o_n, _t_y_p_e,
  13.        _v_a_l_u_e, _l_e_n_g_t_h, _f_o_r_m_a_t)
  14.          Widget _r_e_q_u_e_s_t_o_r;
  15.          Atom _s_e_l_e_c_t_i_o_n;
  16.          Atom _t_y_p_e;
  17.          XtPointer _v_a_l_u_e;
  18.          unsigned long _l_e_n_g_t_h;
  19.          int _f_o_r_m_a_t;
  20.  
  21.  
  22. AARRGGUUMMEENNTTSS
  23.        _r_e_q_u_e_s_t_o_r Specifies the widget making the request. Must be
  24.          of clase Core or any subclass thereof.
  25.  
  26.        _s_e_l_e_c_t_i_o_n Specifies the atom that names the selection.
  27.  
  28.        _t_y_p_e     Specifies the type of the property in which the
  29.          parameters will be passed.
  30.  
  31.        _v_a_l_u_e     Specifies a pointer to the parameters.
  32.  
  33.        _l_e_n_g_t_h     Specifies the number of elements containing data
  34.          in _v_a_l_u_e, each element of a sized indicated by
  35.          _f_o_r_m_a_t.
  36.  
  37.        _f_o_r_m_a_t     Specifies the size in bits of the data in the
  38.          elements of _v_a_l_u_e.
  39.  
  40. DDEESSCCRRIIPPTTIIOONN
  41.        The specified parameters will be copied and stored in a
  42.        new property of the specified type and format on the
  43.        requestor's window. To initiate a selection request with a
  44.        target and these parameters, a subsequent call to _X_t_G_e_t_S_e_-
  45.        _l_e_c_t_i_o_n_V_a_l_u_e or to _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 specify-
  46.        ing the same requestor widget and selection atomm will
  47.        generate a _C_o_n_v_e_r_t_S_e_l_e_c_t_i_o_n request referring referring to
  48.        the property containing the parameters. If _X_t_S_e_t_S_e_l_e_c_t_i_o_n_-
  49.        _P_a_r_a_m_e_t_e_r_s is called more than once with the same widget
  50.        and selection without a call to specify a request, the
  51.        most recently specified parameters are used in the subse-
  52.        quent request.
  53.  
  54.        The possible values of _f_o_r_m_a_t may be 8, 16, or 32. If the
  55.        _f_o_r_m_a_t is 8, the elements of _v_a_l_u_e are assumed to be
  56.        sizeof(char); if 16, sizeof(short); if 32, sizeof(long).
  57.  
  58.        To generate a MULTIPLE target request with parameters for
  59.        any of the multiple targets of the selection request, pre-
  60.        cede individual calls to _X_t_G_e_t_S_e_l_e_c_t_i_o_n_V_a_l_u_e and
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XtSetSelectionParameters(3XtX)T FUNCTIOXNtSSetSelectionParameters(3Xt)
  71.  
  72.  
  73.        _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 corresponding individ-
  74.        ual calls to _X_t_S_e_t_S_e_l_e_c_t_i_o_n_P_a_r_a_m_e_t_e_r_s, and enclose these
  75.        all within _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
  76.        _X_t_S_e_n_d_S_e_l_e_c_t_i_o_n_R_e_q_u_e_s_t.    _X_t_G_e_t_S_e_l_e_c_t_i_o_n_V_a_l_u_e_s and _X_t_G_e_t_S_e_-
  77.        _l_e_c_t_i_o_n_V_a_l_u_e_s_I_n_c_r_e_m_e_n_t_a_l cannot be used    to make selection
  78.        requests with parameterized targets.
  79.  
  80. SSEEEE AALLSSOO
  81.        XtGetSelectionParameters(3Xt)
  82.        _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
  83.        _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  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.