Input Method handling

Functions
const char *	im_get_curr_im_name (iml_session_t *s)
	Get name of current IM.
int	im_propagate_focus_event (iml_session_t *s, int focused)
	Propagates focus event to IM.
int	im_propagate_key_event (iml_session_t *s, IMKeyListEvent *kev)
	Propagates key event event to IM.
void	im_change_to_next_im (iml_session_t *s)
	Changes current IM to the next IM in list.
void	im_change_to_next_im1 (iml_session_t *s)
	Changes current IM to the next IM in list.
void	im_change_to_prev_im (iml_session_t *s)
	Changes current IM to the previous IM in list.
void	im_change_to_prev_im1 (iml_session_t *s)
	Changes current IM to the previous IM in list.
void	im_change_to_im (iml_session_t *s, char *imid)
	Changes current IM by ID.
int	im_propagate_lookup_page_turn_event (iml_session_t *s, int direction)
	Propagates lookup page turn event to IM.
int	im_propagate_lookup_select_event (iml_session_t *s, int num)
	Propagates lookup selection event to IM.

---

Detailed Description

These functions handle the propagation of events to IM, and some convenience functions for getting and setting the current IM.

---

Function Documentation

void im_change_to_im	(	iml_session_t *	s,
		char *	imid
	)

Changes current IM by ID.

Parameters:

	s	current IMLSession
	imid	IM ID string

void im_change_to_next_im

(

iml_session_t *

s

)

Changes current IM to the next IM in list.

The list of IMs considered is defined by the user.

Bug:

Currently this asks Aux to change to the next IM because the IM list is inside Aux. This is very wrong.

Parameters:

s

current IMLSession

void im_change_to_next_im1

(

iml_session_t *

s

)

Changes current IM to the next IM in list.

The list of IMs considered is the full list from IM Manager.

Parameters:

s

current IMLSession

void im_change_to_prev_im

(

iml_session_t *

s

)

Changes current IM to the previous IM in list.

The list of IMs considered is defined by the user.

Bug:

Currently this asks Aux to change to the next IM because the IM list is inside Aux. This is very wrong.

Parameters:

s

current IMLSession

void im_change_to_prev_im1

(

iml_session_t *

s

)

Changes current IM to the previous IM in list.

The list of IMs considered is the full list from IM Manager.

Parameters:

s

current IMLSession

const char* im_get_curr_im_name

(

iml_session_t *

s

)

Get name of current IM.

Parameters:

s

current IMLSession

Returns:

the name of the current IM. This string is owned by IM Manager and must not be modified or freed by the caller.

int im_propagate_focus_event	(	iml_session_t *	s,
		int	focused
	)

Propagates focus event to IM.

Parameters:

	s	current IMLSession
	focused	1 = focus in, 0 = focus out

Returns:

True if handled by IM, False otherwise.

int im_propagate_key_event	(	iml_session_t *	s,
		IMKeyListEvent *	kev
	)

Propagates key event event to IM.

Parameters:

	s	current IMLSession
	kev	IMKeyListEvent

Bug:

Only the first key event in IMKeyListEvent will be propagated even if there are more than one event in the list.

Returns:

True if handled by IM, False otherwise.

int im_propagate_lookup_page_turn_event	(	iml_session_t *	s,
		int	direction
	)

Propagates lookup page turn event to IM.

Parameters:

	s	current IMLSession
	direction	1 = next page, -1 = previous page

Returns:

True if handled by IM, False otherwise.

int im_propagate_lookup_select_event	(	iml_session_t *	s,
		int	num
	)

Propagates lookup selection event to IM.

Parameters:

	s	current IMLSession
	num	lookup choice number selected

Returns:

True if handled by IM, False otherwise.

---