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 context

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 XNResetState
     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 procedures must return a  non-NULL  string.
     If  there	is  no visible preedit text, then it is input method implementa-
     tion-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.13 		   XmbResetIC(3)

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

home | help