hpux man page for xhpgeteurasiancvt

XHPGetEurasianCvt(3X)													     XHPGetEurasianCvt(3X)

NAME
       XHPGetEurasianCvt - return the convert routine for Eurasian keyboards

SYNOPSIS
       #include <X11/XHPlib.h>

       PFI
       XHPGetEurasianCvt(display)
       Display *display;

DESCRIPTION
       XHPGetEurasianCvt will return the convert routine required by XHPConvertLookup to convert keysyms to HP character codes.  The display
       argument is used to identify the keymap currently associated with the display structure.

       Note that calling XHPGetEurasianCvt forces all convert routines for all character sets that correspond to HP keyboards to be linked with
       your code.  If this is not desired, this routine should not be used.

       Users of this routine will also want to perform initialization of the keyboard previous to its use in XHPConvertLookup.	A macro has been
       provided that will do this.  This macro, XHPInputInit, should be called as part of the initialization of any client making use
       XHPGetEurasianCvt.

       XHPConvertLookup and XHPGetEurasianCvt 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
       XHPGetEurasianCvt returns a pointer to the convert routine if it succeeds; it returns zero upon failure.

EXAMPLES
       The following is an extract from an application that supports all the default character sets for HP's Eurasian keyboards.  The call to
       XHPConvertLookup converts a keyevent to a keysym, and then into a string of characters.	The function returned by XHPGetEurasianCvt tells
       XHPConvertLookup into which HP character set the string is to be encoded.

       Display *display;
       XComposeStatus *status;

       XHPInputInit(display, status);
	.
	.
	.
       count = XHPConvertLookup (event, buffer, nbytes, &keysym, status,
					 XHPGetEurasianCvt(display));

ORIGIN
       Hewlett-Packard Company

SEE ALSO
       XHPConvertLookup(3X), XHPInputChinese_s(3X), XHPInputChinese_t(3X), XHPInputJapanese(3X), XHPInputKorean(3X), XHPInputRoman8(3X),
       XHPSetKeyboardMapping(3X)

X Version 11							     Release 5						     XHPGetEurasianCvt(3X)