IBusKeymap

IBusKeymap — Keyboard mapping handling.

Stability Level

Stable, unless otherwise indicated

Synopsis

struct              IBusKeymap;
struct              IBusKeymapClass;
IBusKeymap *        ibus_keymap_new                     (const gchar *name);
IBusKeymap *        ibus_keymap_get                     (const gchar *name);
guint               ibus_keymap_lookup_keysym           (IBusKeymap *keymap,
                                                         guint16 keycode,
                                                         guint32 state);

Object Hierarchy

  GObject
   +----GInitiallyUnowned
         +----IBusObject
               +----IBusKeymap

Description

An IBusKeymap defines the mapping between keyboard scancodes and keyboard symbols such as numbers, alphabets, and punctuation marks.

Some input methods assume certain keyboard layout (such as Chewing and Wubi requires an US-QWERTY layout), and expect key symbols to be arranged in that order. These input methods should new an IBusKeymap instance and define the keyboard layout. Then ibus_keymap_lookup_keysym() can convert scancodes back to the key symbols.

see_also: IBusComponent, IBusEngineDesc

Details

struct IBusKeymap

struct IBusKeymap {
    gchar *name;
    guint keymap[256][7];
};

A keymap object in IBus.

gchar *`name`;	The name of the keymap, such as 'us', 'jp'.
guint `keymap`[256][7];	Keymap table. IME developers normally don have to touch this.

struct IBusKeymapClass

struct IBusKeymapClass {
    IBusObjectClass parent;
};

ibus_keymap_new ()

IBusKeymap *        ibus_keymap_new                     (const gchar *name);

Warning

ibus_keymap_new is deprecated and should not be used in newly-written code. This function has been deprecated and should not be used in newly written code. Please use ibus_keymap_get().

Get an IBusKeymap associated with the giving name.

This function loads the keymap file specified in name in the IBUS_DATA_DIR/keymaps directory.

`name` :	The keymap file to be loaded, such as 'us', 'jp'.
Returns :	An IBusKeymap associated with the giving name; or NULL if failed.

ibus_keymap_get ()

IBusKeymap *        ibus_keymap_get                     (const gchar *name);

Get an IBusKeymap associated with the giving name.

This function loads the keymap file specified in name in the IBUS_DATA_DIR/keymaps directory.

`name` :	The keymap file to be loaded, such as 'us', 'jp'.
Returns :	An IBusKeymap associated with the giving name; or NULL if failed.

ibus_keymap_lookup_keysym ()

guint               ibus_keymap_lookup_keysym           (IBusKeymap *keymap,
                                                         guint16 keycode,
                                                         guint32 state);

Convert the scancode to keysym, given the keymap.

`keymap` :	An IBusKeymap.
`keycode` :	A scancode to be converted.
`state` :	Modifier flags(such as Ctrl, Shift).
Returns :	Corresponding keysym.

			IBus Reference Manual
Top \| Description \| Object Hierarchy