Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XmbResetIC(3)			XLIB FUNCTIONS			 XmbResetIC(3)

NAME
       XmbResetIC, XwcResetIC, Xutf8ResetIC - reset the	state of an input con-
       text

SYNTAX

       char *XmbResetIC(XIC ic);

       wchar_t *XwcResetIC(XIC ic);

       char *Xutf8ResetIC(XIC ic);

ARGUMENTS
       ic	 Specifies the input context.

DESCRIPTION
       When XNResetState is set	to XIMInitialState, XmbResetIC,	XwcResetIC and
       Xutf8ResetIC reset an input context to its initial state; when XNReset-
       State  is  set  to XIMPreserveState, 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	XmbResetIC, XwcResetIC
       or Xutf8ResetIC does not	change the focus.

       The return value	of XmbResetIC is  its  current	preedit	 string	 as  a
       multibyte  string.   The	 return	 value	of  XwcResetIC	is its current
       preedit string as  a  wide  character  string.	The  return  value  of
       Xutf8ResetIC  is	 its  current  preedit	string as an UTF-8 string.  If
       there is	any preedit text drawn or visible to the user, then these pro-
       cedures 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 XFree.

       The function Xutf8ResetIC is an extension  introduced  by  The  XFree86
       Project,	 Inc.,	in  their 4.0.2	release.  Its presence is indicated by
       the macro X_HAVE_UTF8_STRING.

SEE ALSO
       XCreateIC(3), XOpenIM(3), XSetICFocus(3), XSetICValues(3)
       Xlib - C	Language X Interface

X Version 11			 libX11	1.8.12			 XmbResetIC(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XwcResetIC&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help