gtk/modules/input/README.multipress
Matthias Clasen f326c1e9ec Add the multipress input method. (#417446, Johannes Schmid, Murray
2007-03-18  Matthias Clasen <mclasen@redhat.com> 

        * modules/input/gtkimcontextmultipress.[hc]:
        * modules/input/im-multipress.conf:
        * modules/input/immultipress.c:
        * modules/input/README.multipress: Add the multipress input
        method.  (#417446, Johannes Schmid, Murray Cumming)

        * modules/input/Makefile.am: Glue



svn path=/trunk/; revision=17541
2007-03-18 05:34:24 +00:00

43 lines
1.4 KiB
Plaintext

*** Introduction
This is a GTK+ input method which allows text entry via the multi-press method,
as on a mobile phone. When this has been installed, you can choose the "Multipress"
menu item from the "Input Methods" submenu when right-clicking in a GTK+ text entry
area.
For instance:
- press a to get a, then wait 1 second for the character to be accepted.
or
- press dd to get e, then wait 1 second for the character to be accepted.
or
- press ad to get ad, then wait 1 second for the d character to be accepted.
*** Configuration
Edit the im-multipress.conf to define the keypresses needed to input particular characters.
This file is in GKeyFile-format, and contains explanatory comments.
*** Per-widget deactivation
When the input method is active (either by choosing it from the context menu, or
by defining the default language as "*" in src/im-multipress.c), the multipress
behaviour can be turned off for individual widgets, like so:
g_object_set_data(G_OBJECT(yourwidget), "multipress-passthrough-flag", GINT_TO_POINTER(1));
For a C++ gtkmm project, you could make a convenience function to do this. For instance:
void multipress_deactivate(Gtk::Widget& widget)
{
g_object_set_data(G_OBJECT(widget.gobj()), "multipress-passthrough-flag", GINT_TO_POINTER(1));
}
*** Contact
Please contact Openismus for assistance with this input method. You can email murrayc@openismus.com
Copyright 2006-2007, Openismus GmbH