NAME
XmbResetIC, XwcResetIC, Xutf8ResetIC - reset the state of an input context
SYNTAX
char *XmbResetIC(XIC _i_c);
wchar_t *XwcResetIC(XIC _i_c);
char *Xutf8ResetIC(XIC _i_c);
ARGUMENTS
-
_i_c
Specifies the input context.
-
DESCRIPTION
When
_X_N_R_e_s_e_t_S_t_a_t_e
is set to
_X_I_M_I_n_i_t_i_a_l_S_t_a_t_e,
_X_m_b_R_e_s_e_t_I_C,
_X_w_c_R_e_s_e_t_I_C
and
_X_u_t_f_8_R_e_s_e_t_I_C
reset an input context to its initial state;
when
_X_N_R_e_s_e_t_S_t_a_t_e
is set to
_X_I_M_P_r_e_s_e_r_v_e_S_t_a_t_e,
the current input context state is preserved.
In both cases, any input pending on that context is deleted.
The input method is required to clear the preedit area, if any,
and update the status accordingly.
Calling
_X_m_b_R_e_s_e_t_I_C,
_X_w_c_R_e_s_e_t_I_C
or
_X_u_t_f_8_R_e_s_e_t_I_C
does not change the focus.
The return value of
_X_m_b_R_e_s_e_t_I_C
is its current preedit string as a multibyte string.
The return value of
_X_w_c_R_e_s_e_t_I_C
is its current preedit string as a wide character string.
The return value of
_X_u_t_f_8_R_e_s_e_t_I_C
is its current preedit string as an UTF-8 string.
If there is any preedit text drawn or visible to the user,
then these procedures must return a non-NULL string.
If there is no visible preedit text,
then it is input method implementation-dependent
whether these procedures return a non-NULL string or NULL.
The client should free the returned string by calling
_X_F_r_e_e.
The function
_X_u_t_f_8_R_e_s_e_t_I_C
is an XFree86 extension introduced in XFree86 4.0.2. Its presence is
indicated by the macro
_X___H_A_V_E___U_T_F_8___S_T_R_I_N_G.
SEE ALSO
XCreateIC(3X11),
XOpenIM(3X11),
XSetICFocus(3X11),
XSetICValues(3X11)
_X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e