minput_open_im(3m17n) [debian man page]

minput_open_im(3m17n)						 The m17n Library					     minput_open_im(3m17n)

NAME

       minput_open_im - Open an input method.

SYNOPSIS

       MInputMethod* minput_open_im (MSymbol language, MSymbol name, void * arg)

DESCRIPTION

       Open an input method. The minput_open_im() function opens an input method whose language and name match language and name, and returns a
       pointer to the input method object newly allocated.

       This function at first decides a driver for the input method as described below.

       If language is not Mnil, the driver pointed by the variable minput_driver is used.

       If language is Mnil and name has the property Minput_driver, the driver pointed to by the property value is used to open the input method.
       If name has no such a property, NULL is returned.

       Then, the member MInputDriver::open_im() of the driver is called.

       arg is set in the member arg of the structure MInputMethod so that the driver can refer to it.

COPYRIGHT

       Copyright (C) 2001 Information-technology Promotion Agency (IPA)
       Copyright (C) 2001-2011 National Institute of Advanced Industrial Science and Technology (AIST)
       Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License
       <http://www.gnu.org/licenses/fdl.html>.

Version 1.6.2							    12 Jan 2011 					     minput_open_im(3m17n)

minput_config_variable(3m17n)					 The m17n Library				     minput_config_variable(3m17n)

NAME

       minput_config_variable - Configure the value of an input method variable.

SYNOPSIS

       int minput_config_variable (MSymbol language, MSymbol name, MSymbol variable, MPlist * value)

DESCRIPTION

       Configure the value of an input method variable. The minput_config_variable() function assigns value to the variable variable of the input
       method specified by language and name.

       If value is a non-empty plist, it must be a plist of one element whose key is Minteger, Msymbol, or Mtext, and the value is of the
       corresponding type. That value is assigned to the variable.

       If value is an empty plist, any configuration and customization of the variable are canceled, and the default value is assigned to the
       variable.

       If value is NULL, the configuration of the variable is canceled, and the original value (what saved in per-user customization file, or the
       default value) is assigned to the variable.

       In the latter two cases, variable can be Mnil to make all the variables of the input method the target of the operation.

       If name is Mnil, this function configures the value of global variable, not that of a specific input method.

       The configuration takes effect for input methods opened or re-opened later in the current session. To make the configuration take effect
       for the future session, it must be saved in a per-user customization file by the function minput_save_config().

RETURN VALUE

       If the operation was successful, this function returns 0, otherwise returns -1. The operation fails in these cases:

       o value is not in a valid form, the type does not match the definition, or the value is our of range.
       o variable is not available for the input method.
       o language and name do not specify an existing input method.
SEE ALSO

	   minput_get_variable(), minput_save_config().
COPYRIGHT

       Copyright (C) 2001 Information-technology Promotion Agency (IPA)
       Copyright (C) 2001-2011 National Institute of Advanced Industrial Science and Technology (AIST)
       Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License
       <http://www.gnu.org/licenses/fdl.html>.

Version 1.6.2							    12 Jan 2011 				     minput_config_variable(3m17n)