XHPInputChinese_s(3X)													     XHPInputChinese_s(3X)

NAME

       XHPInputChinese_s - map keysyms into Chinese_s characters.

SYNOPSIS

	int XHPInputChinese_s(display, keysym, modifiers, buffer_return, bytes_buffer, status_in_out)
	    Display *display;
	    KeySym *keysym;
	    unsigned int modifiers;
	    char *buffer_return;
	    int bytes_buffer;
	    XComposeStatus *status_in_out;

DESCRIPTION

       display	      Specifies the connection to the X server.

       keysym	      Specifies the keysym that is to be converted into a character.

       modifiers      Specifies the modifiers to be applied to the keysym.

       buffer_return  Returns the translated characters.

       bytes_buffer   Specifies the length of the buffer.  No more than bytes_buffer of translation are returned.

       status_in_out  Specifies the XComposeStatus structure.

       XHPInputChinese_s will convert keysym into an ASCII character, if appropriate.  It will also handle 16-bit input using NLIO.  If the value
       pointed to by keysym is used by the NLIO server, that value will be changed to NoSymbol.  It will use status_in_out to keep the state
       information necessary to control NLIO.  This structure must contain null values before this routine is first invoked, and must remain
       unchanged between uses.

       This routine will also process the control modifier.

       XHPInputChinese_s will use /usr/lbin/X11/xc0input as the NLIO server.  NLIO input will be invoked when  the right extend char key is hit,
       and it will be terminated when the left extend char key is hit.	If the appropriate server is not running it will be started when it is
       first invoked.

       Users of this routine may want to exec the NLIO server previous to it being started up when the invoke key is first struck. This can also
       be accomplished using XHPNlioctl.

       The keys used to invoke and terminate the NLIO server can also be changed using XHPNlioctl.

       This routine is intended to be used in conjunction with XHPConvertLookup

       XHPConvertLookup and XHPInputChinese_s are provided for backwards compatibility only; these routines will be discontinued in a future
       release of HP-UX.  Users desiring the same capabilities as those provided by these routines should use XOpenIM, XCreateIC, and
       XmbLookupString.

RETURN VALUE

       The return value is the length of the string returned in buffer_return.

ORIGIN

       Hewlett-Packard Company

SEE ALSO

       XHPConvertLookup(3X), XHPNlioctl(3X)

INTERNATIONAL SUPPORT

       8-bit and 16-bit character data.

X Version 11							     Release 5						     XHPInputChinese_s(3X)