:right-sidebar: True

IMContextSimple
===================================================================

.. currentmodule:: gi.repository.Gtk





.. class:: IMContextSimple(**properties: ~typing.Any)
   :no-contents-entry:


Superclasses: :class:`~gi.repository.Gtk.IMContext`, :class:`~gi.repository.GObject.Object`





``GtkIMContextSimple`` is an input method supporting table-based input methods.

Compose sequences
-----------------

``GtkIMContextSimple`` reads compose sequences from the first of the
following files that is found: ~/.config/gtk-4.0/Compose, ~/.XCompose,
/usr/share/X11/locale/$locale/Compose (for locales that have a nontrivial
Compose file). A subset of the file syntax described in the Compose(5)
manual page is supported. Additionally, `include "``%L``"` loads GTK’s built-in
table of compose sequences rather than the locale-specific one from X11.

If none of these files is found, ``GtkIMContextSimple`` uses a built-in table
of compose sequences that is derived from the X11 Compose files.

Note that compose sequences typically start with the Compose_key, which is
often not available as a dedicated key on keyboards. Keyboard layouts may
map this keysym to other keys, such as the right Control key.

Unicode characters
------------------

``GtkIMContextSimple`` also supports numeric entry of Unicode characters
by typing :kbd:`Ctrl`-:kbd:`Shift`-:kbd:`u`, followed by a
hexadecimal Unicode codepoint.

For example,

    Ctrl-Shift-u 1 2 3 Enter

yields U+0123 LATIN SMALL LETTER G WITH CEDILLA, i.e. ģ.

Dead keys
---------

``GtkIMContextSimple`` supports dead keys. For example, typing

    dead_acute a

 yields U+00E! LATIN SMALL LETTER_A WITH ACUTE, i.e. á. Note that this
 depends on the keyboard layout including dead keys.



Constructors
------------

.. rst-class:: interim-class

.. class:: IMContextSimple
   :no-index:


   .. classmethod:: new() -> ~gi.repository.Gtk.IMContext

      Creates a new ``GtkIMContextSimple``.














Methods
-------

.. rst-class:: interim-class

.. class:: IMContextSimple
   :no-index:


   .. method:: add_compose_file(compose_file: str) -> None

      Adds an additional table from the X11 compose file.







      :param compose_file: The path of compose file















Fields
------

.. rst-class:: interim-class

.. class:: IMContextSimple
   :no-index:
   

   .. attribute:: object

      






   .. attribute:: priv