IBusEngine

IBusEngine — Input method engine abstract.

Stability Level

Stable, unless otherwise indicated

Synopsis

                    IBusEngine;
IBusEngine*         ibus_engine_new                     (const gchar *name,
                                                         const gchar *path,
                                                         IBusConnection *connection);
void                ibus_engine_commit_text             (IBusEngine *engine,
                                                         IBusText *text);
void                ibus_engine_update_preedit_text     (IBusEngine *engine,
                                                         IBusText *text,
                                                         guint cursor_pos,
                                                         gboolean visible);
void                ibus_engine_show_preedit_text       (IBusEngine *engine);
void                ibus_engine_hide_preedit_text       (IBusEngine *engine);
void                ibus_engine_update_auxiliary_text   (IBusEngine *engine,
                                                         IBusText *text,
                                                         gboolean visible);
void                ibus_engine_show_auxiliary_text     (IBusEngine *engine);
void                ibus_engine_hide_auxiliary_text     (IBusEngine *engine);
void                ibus_engine_update_lookup_table     (IBusEngine *engine,
                                                         IBusLookupTable *lookup_table,
                                                         gboolean visible);
void                ibus_engine_update_lookup_table_fast
                                                        (IBusEngine *engine,
                                                         IBusLookupTable *lookup_table,
                                                         gboolean visible);
void                ibus_engine_show_lookup_table       (IBusEngine *engine);
void                ibus_engine_hide_lookup_table       (IBusEngine *engine);
void                ibus_engine_forward_key_event       (IBusEngine *engine,
                                                         guint keyval,
                                                         guint state);
void                ibus_engine_register_properties     (IBusEngine *engine,
                                                         IBusPropList *prop_list);
void                ibus_engine_update_property         (IBusEngine *engine,
                                                         IBusProperty *prop);
const gchar*        ibus_engine_get_name                (IBusEngine *engine);

Object Hierarchy

  GObject
   +----IBusObject
         +----IBusService
               +----IBusEngine

Properties

  "connection"               IBusConnection*       : Read / Write / Construct Only
  "name"                     gchar*                : Read / Write / Construct Only

Signals

  "candidate-clicked"                              : Run Last
  "cursor-down"                                    : Run Last
  "cursor-up"                                      : Run Last
  "disable"                                        : Run Last
  "enable"                                         : Run Last
  "focus-in"                                       : Run Last
  "focus-out"                                      : Run Last
  "page-down"                                      : Run Last
  "page-up"                                        : Run Last
  "process-key-event"                              : Run Last
  "property-activate"                              : Run Last
  "property-hide"                                  : Run Last
  "property-show"                                  : Run Last
  "reset"                                          : Run Last
  "set-capabilities"                               : Run Last
  "set-cursor-location"                            : Run Last

Description

An IBusEngine provides infrastructure for input method engine. Developers can "extend" this class for input method engine development.

Details

IBusEngine

typedef struct {
    gboolean enabled;
    gboolean has_focus;

    /* cursor location */
    IBusRectangle cursor_area;
    guint client_capabilities;
} IBusEngine;

IBusEngine properties.

gboolean enabled;

Whether the engine is enabled.

gboolean has_focus;

Whether the engine has focus.

IBusRectangle cursor_area;

Area of cursor.

guint client_capabilities;

IBusCapabilite (client capabilities) flags.

ibus_engine_new ()

IBusEngine*         ibus_engine_new                     (const gchar *name,
                                                         const gchar *path,
                                                         IBusConnection *connection);

New an IBusEngine.

name :

Name of the IBusObject.

path :

Path for IBusService.

connection :

An opened IBusConnection.

Returns :

A newly allocated IBusEngine.

ibus_engine_commit_text ()

void                ibus_engine_commit_text             (IBusEngine *engine,
                                                         IBusText *text);

Commit output of input method to IBus client.

engine :

An IBusEngine.

text :

String commit to IBusEngine.

ibus_engine_update_preedit_text ()

void                ibus_engine_update_preedit_text     (IBusEngine *engine,
                                                         IBusText *text,
                                                         guint cursor_pos,
                                                         gboolean visible);

Update the pre-edit buffer.

engine :

An IBusEngine.

text :

Update content.

cursor_pos :

Current position of cursor

visible :

Whether the pre-edit buffer is visible.

ibus_engine_show_preedit_text ()

void                ibus_engine_show_preedit_text       (IBusEngine *engine);

Show the pre-edit buffer.

engine :

An IBusEngine.

ibus_engine_hide_preedit_text ()

void                ibus_engine_hide_preedit_text       (IBusEngine *engine);

Hide the pre-edit buffer.

engine :

An IBusEngine.

ibus_engine_update_auxiliary_text ()

void                ibus_engine_update_auxiliary_text   (IBusEngine *engine,
                                                         IBusText *text,
                                                         gboolean visible);

Update the auxiliary bar.

engine :

An IBusEngine.

text :

Update content.

visible :

Whether the auxiliary text bar is visible.

ibus_engine_show_auxiliary_text ()

void                ibus_engine_show_auxiliary_text     (IBusEngine *engine);

Show the auxiliary bar.

engine :

An IBusEngine.

ibus_engine_hide_auxiliary_text ()

void                ibus_engine_hide_auxiliary_text     (IBusEngine *engine);

Hide the auxiliary bar.

engine :

An IBusEngine.

ibus_engine_update_lookup_table ()

void                ibus_engine_update_lookup_table     (IBusEngine *engine,
                                                         IBusLookupTable *lookup_table,
                                                         gboolean visible);

Update the lookup table.

engine :

An IBusEngine.

lookup_table :

An lookup_table.

visible :

Whether the lookup_table is visible.

ibus_engine_update_lookup_table_fast ()

void                ibus_engine_update_lookup_table_fast
                                                        (IBusEngine *engine,
                                                         IBusLookupTable *lookup_table,
                                                         gboolean visible);

Fast update for big lookup table.

If size of lookup table is not over table page size *4, then it calls ibus_engine_update_lookup_table().

engine :

An IBusEngine.

lookup_table :

An lookup_table.

visible :

Whether the lookup_table is visible.

ibus_engine_show_lookup_table ()

void                ibus_engine_show_lookup_table       (IBusEngine *engine);

Show the lookup table.

engine :

An IBusEngine.

ibus_engine_hide_lookup_table ()

void                ibus_engine_hide_lookup_table       (IBusEngine *engine);

Hide the lookup table.

engine :

An IBusEngine.

ibus_engine_forward_key_event ()

void                ibus_engine_forward_key_event       (IBusEngine *engine,
                                                         guint keyval,
                                                         guint state);

Forward the key event.

engine :

An IBusEngine.

keyval :

KeySym.

state :

Key modifier flags.

ibus_engine_register_properties ()

void                ibus_engine_register_properties     (IBusEngine *engine,
                                                         IBusPropList *prop_list);

Register and show properties in language bar.

engine :

An IBusEngine.

prop_list :

Property List.

ibus_engine_update_property ()

void                ibus_engine_update_property         (IBusEngine *engine,
                                                         IBusProperty *prop);

Update the state displayed in language bar.

engine :

An IBusEngine.

prop :

IBusProperty to be updated.

ibus_engine_get_name ()

const gchar*        ibus_engine_get_name                (IBusEngine *engine);

Return the name of IBusEngine.

engine :

An IBusEngine.

Returns :

Name of IBusEngine.

Property Details

The "connection" property

  "connection"               IBusConnection*       : Read / Write / Construct Only

Connection of this IBusEngine.


The "name" property

  "name"                     gchar*                : Read / Write / Construct Only

Name of this IBusEngine.

Default value: "noname"

Signal Details

The "candidate-clicked" signal

void                user_function                      (IBusEngine *engine,
                                                        guint       arg1,
                                                        guint       arg2,
                                                        guint       arg3,
                                                        gpointer    user_data)      : Run Last

Emitted when candidate on lookup table is clicked. Implement the member function candidate_clicked() in extended class to receive this signal.

Note

user_data is not actually a valid parameter. It is displayed because of GtkDoc bug.

engine :

An IBusEngine.

user_data :

user data set when the signal handler was connected.

The "cursor-down" signal

void                user_function                      (IBusEngine *engine,
                                                        gpointer    user_data)      : Run Last

Emitted when the down cursor button is pressed. Implement the member function cursor_down() in extended class to receive this signal.

Note

user_data is not actually a valid parameter. It is displayed because of GtkDoc bug.

engine :

An IBusEngine.

user_data :

user data set when the signal handler was connected.

The "cursor-up" signal

void                user_function                      (IBusEngine *engine,
                                                        gpointer    user_data)      : Run Last

Emitted when the up cursor button is pressed. Implement the member function cursor_up() in extended class to receive this signal.

Note

user_data is not actually a valid parameter. It is displayed because of GtkDoc bug.

engine :

An IBusEngine.

user_data :

user data set when the signal handler was connected.

The "disable" signal

void                user_function                      (IBusEngine *engine,
                                                        gpointer    user_data)      : Run Last

Emitted when the IME is disabled. Implement the member function set_disable() in extended class to receive this signal.

Note

user_data is not actually a valid parameter. It is displayed because of GtkDoc bug.

engine :

An IBusEngine.

user_data :

user data set when the signal handler was connected.

The "enable" signal

void                user_function                      (IBusEngine *engine,
                                                        gpointer    user_data)      : Run Last

Emitted when the IME is enabled. Implement the member function set_enable() in extended class to receive this signal.

Note

user_data is not actually a valid parameter. It is displayed because of GtkDoc bug.

engine :

An IBusEngine.

user_data :

user data set when the signal handler was connected.

The "focus-in" signal

void                user_function                      (IBusEngine *engine,
                                                        gpointer    user_data)      : Run Last

Emitted when the client application get the focus. Implement the member function focus_in() in extended class to receive this signal.

Note

user_data is not actually a valid parameter. It is displayed because of GtkDoc bug.

engine :

An IBusEngine.

user_data :

user data set when the signal handler was connected.

The "focus-out" signal

void                user_function                      (IBusEngine *engine,
                                                        gpointer    user_data)      : Run Last

Emitted when the client application lost the focus. Implement the member function focus_out() in extended class to receive this signal.

Note

user_data is not actually a valid parameter. It is displayed because of GtkDoc bug.

engine :

An IBusEngine.

user_data :

user data set when the signal handler was connected.

The "page-down" signal

void                user_function                      (IBusEngine *engine,
                                                        gpointer    user_data)      : Run Last

Emitted when the page-down button is pressed. Implement the member function page_down() in extended class to receive this signal.

Note

user_data is not actually a valid parameter. It is displayed because of GtkDoc bug.

engine :

An IBusEngine.

user_data :

user data set when the signal handler was connected.

The "page-up" signal

void                user_function                      (IBusEngine *engine,
                                                        gpointer    user_data)      : Run Last

Emitted when the page-up button is pressed. Implement the member function page_up() in extended class to receive this signal.

Note

user_data is not actually a valid parameter. It is displayed because of GtkDoc bug.

engine :

An IBusEngine.

user_data :

user data set when the signal handler was connected.

The "process-key-event" signal

gboolean            user_function                      (IBusEngine *engine,
                                                        guint       keyval,
                                                        guint       state,
                                                        gpointer    user_data)      : Run Last

Emitted when a key event is received. Implement the member function process_key_event() in extended class to receive this signal.

Note

user_data is not actually a valid parameter. It is displayed because of GtkDoc bug.

engine :

An IBusEngine.

keyval :

KeySym of the key press.

state :

Key modifier flags

user_data :

user data set when the signal handler was connected.

The "property-activate" signal

void                user_function                      (IBusEngine *engine,
                                                        gchar      *arg1,
                                                        guint       arg2,
                                                        gpointer    user_data)      : Run Last

Emitted when a property is activated or change changed. Implement the member function property_activate() in extended class to receive this signal.

Note

user_data is not actually a valid parameter. It is displayed because of GtkDoc bug.

engine :

An IBusEngine.

user_data :

user data set when the signal handler was connected.

The "property-hide" signal

void                user_function                      (IBusEngine *engine,
                                                        gchar      *arg1,
                                                        gpointer    user_data)      : Run Last

Emitted when a property is hidden. Implement the member function property_hide() in extended class to receive this signal.

Note

user_data is not actually a valid parameter. It is displayed because of GtkDoc bug.

engine :

An IBusEngine.

user_data :

user data set when the signal handler was connected.

The "property-show" signal

void                user_function                      (IBusEngine *engine,
                                                        gchar      *arg1,
                                                        gpointer    user_data)      : Run Last

Emitted when a property is shown. Implement the member function property_side() in extended class to receive this signal.

Note

user_data is not actually a valid parameter. It is displayed because of GtkDoc bug.

engine :

An IBusEngine.

user_data :

user data set when the signal handler was connected.

The "reset" signal

void                user_function                      (IBusEngine *engine,
                                                        gpointer    user_data)      : Run Last

Emitted when the IME is reset. Implement the member function reset() in extended class to receive this signal.

Note

user_data is not actually a valid parameter. It is displayed because of GtkDoc bug.

engine :

An IBusEngine.

user_data :

user data set when the signal handler was connected.

The "set-capabilities" signal

void                user_function                      (IBusEngine *engine,
                                                        guint       caps,
                                                        gpointer    user_data)      : Run Last

Emitted when the client application capabilities is set. Implement the member function set_capabilities() in extended class to receive this signal.

Note

user_data is not actually a valid parameter. It is displayed because of GtkDoc bug.

engine :

An IBusEngine.

caps :

Capabilities flags of IBusEngine, see IBusCapabilite

user_data :

user data set when the signal handler was connected.

The "set-cursor-location" signal

void                user_function                      (IBusEngine *engine,
                                                        gint        arg1,
                                                        gint        arg2,
                                                        gint        arg3,
                                                        gint        arg4,
                                                        gpointer    user_data)      : Run Last

Emitted when the location of IME is set. Implement the member function set_cursor_location() in extended class to receive this signal.

Note

user_data is not actually a valid parameter. It is displayed because of GtkDoc bug.

engine :

An IBusEngine.

user_data :

user data set when the signal handler was connected.

See Also

IBusComponent, IBusEngineDesc