home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xgeticvalues.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  3.4 KB  |  133 lines
  1.  
  2.  
  3.  
  4. XSetICValues(3X11)      XLIB FUNCTIONS       XSetICValues(3X11)
  5.  
  6.  
  7. NNAAMMEE
  8.        XSetICValues, XGetICValues - set and obtain XIC values
  9.  
  10. SSYYNNTTAAXX
  11.        char * XSetICValues(_i_c, ...)
  12.          XIC _i_c;
  13.  
  14.        char * XGetICValues(_i_c, ...)
  15.          XIC _i_c;
  16.  
  17. AARRGGUUMMEENNTTSS
  18.        _i_c     Specifies the input context.
  19.  
  20.        ...     Specifies the variable length argument list to
  21.          set or get XIC values.
  22.  
  23. DDEESSCCRRIIPPTTIIOONN
  24.        The _X_S_e_t_I_C_V_a_l_u_e_s function returns NULL if no error
  25.        occurred; otherwise, it returns the name of the first
  26.        argument that could not be set.    An argument might not be
  27.        set for any of the following reasons:
  28.  
  29.        +o    The argument is read-only (for example,
  30.         _X_N_F_i_l_t_e_r_E_v_e_n_t_s).
  31.  
  32.        +o    The argument name is not recognized.
  33.  
  34.        +o    An implementation-dependent error occurs.
  35.  
  36.        Each value to be set must be an appropriate datum, match-
  37.        ing the data type imposed by the semantics of the argu-
  38.        ment.
  39.  
  40.        The _X_S_e_t_I_C_V_a_l_u_e_s can generate _B_a_d_A_t_o_m, _B_a_d_C_o_l_o_r,
  41.        _B_a_d_C_u_r_s_o_r, _B_a_d_P_i_x_m_a_p, and _B_a_d_W_i_n_d_o_w errors.
  42.  
  43.        The _X_G_e_t_I_C_V_a_l_u_e_s function returns NULL if no error
  44.        occurred; otherwise, it returns the name of the first
  45.        argument that could not be obtained.  An argument could
  46.        not be obtained for any of the following reasons:
  47.  
  48.        +o    The argument name is not recognized.
  49.  
  50.        +o    The input method encountered an implementation-
  51.         dependent error.
  52.  
  53.        Each IC attribute value argument (following a name) must
  54.        point to a location where the IC value is to be stored.
  55.        That is, if the IC value is of type T, the argument must
  56.        be of type T*.  If T itself is a pointer type, then _X_G_e_t_-
  57.        _I_C_V_a_l_u_e_s allocates memory to store the actual data, and
  58.        the client is responsible for freeing this data by calling
  59.        _X_F_r_e_e with the returned pointer.     The exception to this
  60.        rule is for an IC value of type _X_V_a_N_e_s_t_e_d_L_i_s_t (for preedit
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XSetICValues(3X11)      XLIB FUNCTIONS       XSetICValues(3X11)
  71.  
  72.  
  73.        and status attributes).    In this case,  the argument must
  74.        also be of type _X_V_a_N_e_s_t_e_d_L_i_s_t.  Then, the rule of changing
  75.        type T to T* and freeing the allocated data applies to
  76.        each element of the nested list.
  77.  
  78. DDIIAAGGNNOOSSTTIICCSS
  79.        _B_a_d_A_t_o_m     A value for an Atom argument does not name a
  80.          defined Atom.
  81.  
  82.        _B_a_d_C_o_l_o_r     A value for a Colormap argument does not name a
  83.          defined Colormap.
  84.  
  85.        _B_a_d_C_u_r_s_o_r A value for a Cursor argument does not name a
  86.          defined Cursor.
  87.  
  88.        _B_a_d_P_i_x_m_a_p A value for a Pixmap argument does not name a
  89.          defined Pixmap.
  90.  
  91.        _B_a_d_W_i_n_d_o_w A value for a Window argument does not name a
  92.          defined Window.
  93.  
  94. SSEEEE AALLSSOO
  95.        XCreateIC(3X11), XOpenIM(3X11), XSetICFocus(3X11), XmbRe-
  96.        setIC(3X11)
  97.        _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  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.