gtk2/modules/input
Chun-wei Fan c255ba68fc input/IME: Defer the emit of the "commit" signal
On Windows, when IME is used, each keystroke results in the
WM_IME_COMPOSITION event being sent first.  This means that in our case
when one decides on to accept the input that is in the preedit buffer,
we first get from Windows the WM_IME_COMPOSITION event
(where we emit the commit signal), followed by the WM_IME_ENDCOMPOSITION
event (where we emit the pair of preedit-changed and preedit-end
signals).

Since commit f11f989 (GtkEntry: Remove recompute idle), we do the input
recomputation directly, this will cause a pair of "Pango-WARNING:
Assertion failed: (index >= 0 && index <= layout->length)" being shown,
as gtkentry.c's priv->preedit_length and priv->preedit_cursor was unable
to be reset to 0 in time as a result of the recomputation triggered by
the commit being done before the reset of priv->preedit_length and
priv->preedit_cursor (which are no longer valid as we essentially say
that we are done with the preedit buffer).

As we could only acquire the final string that was entered in this
preedit session when we handle the WM_IME_COMPOSITION event, fix this by
saving up the final string we acquire from Windows IME in UTF-8 when we
handle the WM_IME_COMPOSITION event from Windows, and emit the commit
signal with that string after we emit the preedit-changed and
preedit-end signals when we handle the WM_IME_ENDCOMPOSITION event from
Windows, which comes afterwards.

Also fix the formatting of the code around the parts of the files that
was changed.

https://bugzilla.gnome.org/show_bug.cgi?id=787142
2017-10-30 14:33:23 +08:00
..
gtkimcontextime.c input/IME: Defer the emit of the "commit" signal 2017-10-30 14:33:23 +08:00
gtkimcontextime.h input/IME: Defer the emit of the "commit" signal 2017-10-30 14:33:23 +08:00
gtkimcontextmultipress.c multipress: Only emit preedit signals if needed 2015-08-18 15:44:45 -04:00
gtkimcontextmultipress.h Change FSF Address 2012-02-27 17:06:11 +00:00
gtkimcontextthai.c Properly check result of g_utf8_get_char_validated() 2015-01-11 15:46:06 -05:00
gtkimcontextthai.h Change FSF Address 2012-02-27 17:06:11 +00:00
gtkimcontextxim.c Some forgotten deprecation cleanup 2016-10-20 13:58:49 -04:00
gtkimcontextxim.h Change FSF Address 2012-02-27 17:06:11 +00:00
im-multipress.conf Remove the namespace prefix from functions defined locally only. Clean up 2009-01-16 15:02:06 +00:00
imam-et.c Make gtk-im-context-none work 2015-02-23 22:06:02 -05:00
imbroadway.c Make gtk-im-context-none work 2015-02-23 22:06:02 -05:00
imcedilla.c Make gtk-im-context-none work 2015-02-23 22:06:02 -05:00
imcyrillic-translit.c Make gtk-im-context-none work 2015-02-23 22:06:02 -05:00
imime.c Make gtk-im-context-none work 2015-02-23 22:06:02 -05:00
iminuktitut.c Make gtk-im-context-none work 2015-02-23 22:06:02 -05:00
imipa.c Make gtk-im-context-none work 2015-02-23 22:06:02 -05:00
imm-extra.h Change FSF Address 2012-02-27 17:06:11 +00:00
immultipress.c Make gtk-im-context-none work 2015-02-23 22:06:02 -05:00
imquartz.c Duplicate the TIC strings before NULLing the GObject data. 2017-08-08 23:19:26 +03:00
imthai.c Make gtk-im-context-none work 2015-02-23 22:06:02 -05:00
imti-er.c Make gtk-im-context-none work 2015-02-23 22:06:02 -05:00
imti-et.c Make gtk-im-context-none work 2015-02-23 22:06:02 -05:00
imviqr.c Make gtk-im-context-none work 2015-02-23 22:06:02 -05:00
imxim.c Make gtk-im-context-none work 2015-02-23 22:06:02 -05:00
Makefile.am Use upstream gettext 2016-05-16 20:46:19 +01:00
README.multipress Maintenance of Multipress input method by Openismus GmbH: 2008-12-10 11:58:37 +00:00
thai-charprop.c Remove the broken Thai input method and add a functional Thai and Lao 2006-11-29 01:14:04 +00:00
thai-charprop.h Change FSF Address 2012-02-27 17:06:11 +00:00

*** 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 immultipress.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)
  {
    static const Glib::Quark quark ("multipress-passthrough-flag");
    widget.set_data(quark, 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