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 / X11 / XSetICValues.z / XSetICValues
Encoding:
Text File  |  2002-10-03  |  4.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXSSSSeeeettttIIIICCCCVVVVaaaalllluuuueeeessss((((3333XXXX11111111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))  XXXXSSSSeeeettttIIIICCCCVVVVaaaalllluuuueeeessss((((3333XXXX11111111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XSetICValues, XGetICValues - set and obtain XIC values
  10.  
  11.      SSSSYYYYNNNNTTTTAAAAXXXX
  12.           char * XSetICValues(_i_c, ...)
  13.                 XIC _i_c;
  14.  
  15.           char * XGetICValues(_i_c, ...)
  16.                 XIC _i_c;
  17.  
  18.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  19.           _i_c        Specifies the input context.
  20.  
  21.           ...       Specifies the variable length argument list to set
  22.                     or get XIC values.
  23.  
  24.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  25.           The _X_S_e_t_I_C_V_a_l_u_e_s function returns NULL if no error occurred;
  26.           otherwise, it returns the name of the first argument that
  27.           could not be set.  An argument might not be set for any of
  28.           the following reasons:
  29.  
  30.           +o    The argument is read-only (for example,
  31.                _X_N_F_i_l_t_e_r_E_v_e_n_t_s).
  32.  
  33.           +o    The argument name is not recognized.
  34.  
  35.           +o    An implementation-dependent error occurs.
  36.  
  37.           Each value to be set must be an appropriate datum, matching
  38.           the data type imposed by the semantics of the argument.
  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, _B_a_d_C_u_r_s_o_r,
  41.           _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 occurred;
  44.           otherwise, it returns the name of the first argument that
  45.           could not be obtained.  An argument could not be obtained
  46.           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 be
  56.           of type T*.  If T itself is a pointer type, then
  57.           _X_G_e_t_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 rule
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXSSSSeeeettttIIIICCCCVVVVaaaalllluuuueeeessss((((3333XXXX11111111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))  XXXXSSSSeeeettttIIIICCCCVVVVaaaalllluuuueeeessss((((3333XXXX11111111))))
  71.  
  72.  
  73.  
  74.           is for an IC value of type _X_N_V_a_N_e_s_t_e_d_L_i_s_t (for preedit and
  75.           status attributes).  In this case,  the argument must also
  76.           be of type _X_V_a_N_e_s_t_e_d_L_i_s_t.  Then, the rule of changing type T
  77.           to T* and freeing the allocated data applies to each element
  78.           of the nested list.
  79.  
  80.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  81.           _B_a_d_A_t_o_m   A value for an Atom argument does not name a
  82.                     defined Atom.
  83.  
  84.           _B_a_d_C_o_l_o_r  A value for a Colormap argument does not name a
  85.                     defined Colormap.
  86.  
  87.           _B_a_d_C_u_r_s_o_r A value for a Cursor argument does not name a
  88.                     defined Cursor.
  89.  
  90.           _B_a_d_P_i_x_m_a_p A value for a Pixmap argument does not name a
  91.                     defined Pixmap.
  92.  
  93.           _B_a_d_W_i_n_d_o_w A value for a Window argument does not name a
  94.                     defined Window.
  95.  
  96.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  97.           XCreateIC(3X11), XOpenIM(3X11), XSetICFocus(3X11),
  98.           XmbResetIC(3X11)
  99.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  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.