XHPGetEurasianCvt(3X)XHPGetEurasianCvt(3X)NAMEXHPGetEurasianCvt - return the convert routine for Eurasian keyboards
SYNOPSIS
#include <X11/XHPlib.h>
PFI
XHPGetEurasianCvt(display)
Display *display;
DESCRIPTIONXHPGetEurasianCvt 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 VALUEXHPGetEurasianCvt 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 ALSOXHPConvertLookup(3X), XHPInputChinese_s(3X), XHPInputChinese_t(3X),
XHPInputJapanese(3X), XHPInputKorean(3X), XHPInputRoman8(3X),
XHPSetKeyboardMapping(3X)X Version 11 Release 5 XHPGetEurasianCvt(3X)