


XCreateIC(3X11)						      XCreateIC(3X11)
X11R5									X11R5



NAME
  XCreateIC, XDestroyIC, XIMOfIC - create, destroy, and	obtain the input
  method of an input context

SYNTAX
  XIC XCreateIC(_i_m, ...)
	XIM _i_m;

  void XDestroyIC(_i_c)
	XIC _i_c;

  XIM XIMOfIC(_i_c)
	XIC _i_c;

ARGUMENTS

  _i_c	    Specifies the input	context.

  _i_m	    Specifies the input	method.

  ......	    Specifies the variable length argument list	to set XIC values.

DESCRIPTION
  The _X_C_r_e_a_t_e_I_C	function creates a context within the specified	input method.

  Some of the arguments	are mandatory at creation time,	and the	input context
  will not be created if they are not provided.	 Those arguments are the
  input	style and the set of text callbacks (if	the input style	selected
  requires callbacks).	All other input	context	values can be set later.

  _X_C_r_e_a_t_e_I_C returns a NULL value if no input context could be created.	A
  NULL value could be returned for any of the following	reasons:

  oo++    A required argument was not set.

  oo++    A read-only argument was	set (for example, _X_N_F_i_l_t_e_r_E_v_e_n_t_s).

  oo++    The argument name is not	recognized.

  oo++    The input method	encountered an input method implementation dependent
       error.

  The _X_C_r_e_a_t_e_I_C	can generate _B_a_d_A_t_o_m, _B_a_d_C_o_l_o_r,	_B_a_d_P_i_x_m_a_p, and _B_a_d_W_i_n_d_o_w
  errors.

  _X_D_e_s_t_r_o_y_I_C destroys the specified input context.

  The _X_I_M_O_f_I_C function returns the input method	associated with	the specified
  input	context.



DIAGNOSTICS

  _B_a_d_A_t_o_m   A value for	an Atom	argument does not name a defined Atom.

  _B_a_d_C_o_l_o_r  A value for	a Colormap argument does not name a defined Colormap.

  _B_a_d_P_i_x_m_a_p A value for	a Pixmap argument does not name	a defined Pixmap.

  _B_a_d_W_i_n_d_o_w A value for	a Window argument does not name	a defined Window.

SEE ALSO
  XOpenIM(3X11), XSetICFocus(3X11), XSetICValues(3X11),	XmbResetIC(3X11)
  _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e



























































