


XOpenIM(3X11)							XOpenIM(3X11)
X11R5									X11R5



NAME
  XOpenIM, XCloseIM, XGetIMValues, XDisplayOfIM, XLocaleOfIM - open, close,
  and obtain input method information

SYNTAX
  XIM XOpenIM(_d_i_s_p_l_a_y, _d_b, _r_e_s__n_a_m_e, _r_e_s__c_l_a_s_s)
	Display	*_d_i_s_p_l_a_y;
	XrmDataBase _d_b;
	char *_r_e_s__n_a_m_e;
	char *_r_e_s__c_l_a_s_s;

  Status XCloseIM(_i_m)
	XIM _i_m;

  char * XGetIMValues(_i_m, ...)
	XIM _i_m;

  Display * XDisplayOfIM(_i_m)
	  XIM _i_m;

  char * XLocaleOfIM(_i_m)
	XIM _i_m;

ARGUMENTS

  _d_b	    Specifies a	pointer	to the resource	database.

  _d_i_s_p_l_a_y   Specifies the connection to	the X server.

  _i_m	    Specifies the input	method.

  _r_e_s__c_l_a_s_s Specifies the full class name of the application.

  _r_e_s__n_a_m_e  Specifies the full resource	name of	the application.

  ......	    Specifies the variable length argument list	to get XIM values.

DESCRIPTION
  The _X_O_p_e_n_I_M function opens an	input method, matching the current locale and
  modifiers specification.  Current locale and modifiers are bound to the
  input	method at opening time.	 The locale associated with an input method
  cannot be changed dynamically.  This implies the strings returned by
  _X_m_b_L_o_o_k_u_p_S_t_r_i_n_g or _X_w_c_L_o_o_k_u_p_S_t_r_i_n_g, for any input context affiliated with a
  given	input method, will be encoded in the locale current at the time	input
  method is opened.

  The specific input method to which this call will be routed is identified
  on the basis of the current locale. _X_O_p_e_n_I_M will identify a default input
  method corresponding to the current locale.  That default can	be modified
  using	_X_S_e_t_L_o_c_a_l_e_M_o_d_i_f_i_e_r_s for	the input method modifier.


  The db argument is the resource database to be used by the input method for
  looking up resources that are	private	to the input method.  It is not
  intended that	this database be used to look up values	that can be set	as IC
  values in an input context.  If db is	NULL, no data base is passed to	the
  input	method.

  The res_name and res_class arguments specify the resource name and class of
  the application. They	are intended to	be used	as prefixes by the input
  method when looking up resources that	are common to all input	contexts that
  may be created for this input	method.	 The characters	used for resource
  names	and classes must be in the X portable character	set.  The resources
  looked up are	not fully specified if res_name	or res_class is	NULL.

  The res_name and res_class arguments are not assumed to exist	beyond the
  call to _X_O_p_e_n_I_M.  The	specified resource database is assumed to exist	for
  the lifetime of the input method.

  _X_O_p_e_n_I_M returns NULL if no input method could	be opened.

  The _X_C_l_o_s_e_I_M function	closes the specified input method.

  The _X_G_e_t_I_M_V_a_l_u_e_s function presents a variable	argument list programming
  interface for	querying properties or features	of the specified input
  method.  This	function returns NULL if it succeeds; otherwise, it returns
  the name of the first	argument that could not	be obtained.

  Only one standard argument is	defined	by Xlib: _X_N_Q_u_e_r_y_I_n_p_u_t_S_t_y_l_e, which
  must be used to query	about input styles supported by	the input method.

  A client should always query the input method	to determine which styles are
  supported.  The client should	then find an input style it is capable of
  supporting.

  If the client	cannot find an input style that	it can support it should
  negotiate with the user the continuation of the program (exit, choose
  another input	method,	and so on).

  The argument value must be a pointer to a location where the returned	value
  will be stored.  The returned	value is a pointer to a	structure of type
  _X_I_M_S_t_y_l_e_s.  Clients are responsible for freeing the _X_I_M_S_t_y_l_e_s	data struc-
  ture.	 To do so, use _X_F_r_e_e.

  The _X_D_i_s_p_l_a_y_O_f_I_M function returns the	display	associated with	the specified
  input	method.

  The _X_L_o_c_a_l_e_O_f_I_M returns the locale associated	with the specified input
  method.

SEE ALSO
  XCreateIC(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	delim off





















