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

modules/input/README.multipress

@@ -0,0 +1,42 @@
+*** 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