Configure m17n input methods

The m17n-im-config package provides:

a C library libm17n-im-config.so) to create a GTK+ widget for per-user configuration of input methods provided by the m17n library
a standalone GTK+ program (m17n-im-config) that uses the above widget.
a SCIM Setup module (scim-m17n-setup.so) to prodive the same facility as above to the program "scim-setup".

Download

The tarball is here: m17n-im-config-0.9.1.tar.gz.
You can also checkout the latest version by anonymous CVS with the following commands:

  % cvs -d :pserver:anonymous@cvs.m17n.org:/cvs/m17n login
  % cvs -d :pserver:anonymous@cvs.m17n.org:/cvs/m17n co m17n-im-config

You can also access to the CVS repository.

Usage of the library

Compiling and Linking

As this package provides pkgconfig data, you can see compiler and linker options by the following commands:

  % pkg-config --cflags m17n-im-config
  % pkg-config --libs m17n-im-config

API

GtkWidget *mim_config_new (GCallback func, gpointer data)

	The mim_config_new () function returns a newly created Gtk+
	widget for for per-user configuration of input methods
	provided by the m17n library.  If the argument FUNC is not
	NULL, it is called when the configuration status is changed
	(because some value is changed or reverted by a user).  The
	function must have two arguments; the widget created by this
	function, and DATA.

	The widget returned must be the argument to the following
	functions.

	This widget is actually a GtkScrolledWindow widget that
	contains a GtkTreeView widget.  You can get this GtkTreeView
	widget by mim_config_get_tree_view () function.

gboolean mim_config_modified (GtkWidget *config)

	The mim_config_modified () function checks if there are any
	unsaved configurations.  If any, TRUE is returned.  Othewise,
	FALSE is returned.

gboolean mim_config_default (GtkWidget *config)

	The mim_config_default () function reset all configurations
	done by a user at the current session, and all customization
	saved in a per-user customization file to the default state.
	If there are any configurations actually reverted, TRUE is
	returned.  Othewise FALSE is returned.

gboolean mim_config_revert (GtkWidget *config)

	The mim_config_revert () function reverts all configurations
	done by a user to the original state.  If there are any
	configurations actually reverted, TRUE is returned.  Othewise
	FALSE is returned.

gboolean mim_config_save (GtkWidget *config)

       The mim_config_save () function saves all configurations done
       by a user into a per-user customization file.  If the file is
       actually written, TRUE is returned.  If there's no configuraion
       to save, FALSE is returned.

GtkTreeView *mim_config_get_tree_view (GtkWidget *config)

	The mim_config_get_tree_view () function returns the
	GtkTreeView widget used in the widget created by
	mim_config_new ().

Usage of m17n-im-config

Just run this program without any arguments.

  % m17n-im-config

It creates a Gtk+ window (see the image below), and allow a user to configure all m17n-lib input methods. The configuration data is stored in the file ~/.m17n.d/config.mic.

Usage of scim-m17n-setup.so

When you run the program "scim-setup", you'll see the tab "M17N Lib" as shown in this image:

When you click that tab, you'll get the similar configulation window as what the program "m17n-im-config" provides.

Contact Address

If you are interested in this project, please write to m17n-lib@m17n.org.