Pileus Git - ~andy/gtk/blob - modules/input/README.multipress

   1 *** Introduction
   2
   3 This is a GTK+ input method which allows text entry via the multi-press method,
   4 as on a mobile phone. When this has been installed, you can choose the "Multipress"
   5 menu item from the "Input Methods" submenu when right-clicking in a GTK+ text entry
   6 area.
   7
   8 For instance:
   9 - press a to get a, then wait 1 second for the character to be accepted.
  10 or
  11 - press dd to get e, then wait 1 second for the character to be accepted.
  12 or
  13 - press ad to get ad, then wait 1 second for the d character to be accepted.
  14
  15
  16 *** Configuration
  17
  18 Edit the im-multipress.conf to define the keypresses needed to input particular characters.
  19 This file is in GKeyFile-format, and contains explanatory comments.
  20
  21
  22 *** Per-widget deactivation
  23
  24 When the input method is active (either by choosing it from the context menu, or
  25 by defining the default language as "*" in immultipress.c), the multipress
  26 behaviour can be turned off for individual widgets, like so:
  27
  28   g_object_set_data(G_OBJECT(yourwidget), "multipress-passthrough-flag", GINT_TO_POINTER(1));
  29
  30
  31 For a C++ gtkmm project, you could make a convenience function to do this. For instance:
  32
  33   void multipress_deactivate(Gtk::Widget& widget)
  34   {
  35     static const Glib::Quark quark ("multipress-passthrough-flag");
  36     widget.set_data(quark, GINT_TO_POINTER(1));
  37   }
  38
  39 *** Contact
  40
  41 Please contact Openismus for assistance with this input method. You can email murrayc@openismus.com
  42
  43 Copyright 2006-2007, Openismus GmbH