XmRegisterSegmentEncoding(UNIX SysteXmRegisterSegmentEncoding(3X)
NAME
XmRegisterSegmentEncoding - A compound string function that
registers a compound text encoding format for a specified
font list element tag
SYNOPSIS
#include <Xm/Xm.h>
char * XmRegisterSegmentEncoding (fontlist_tag, ct_encoding)
char *fontlist_tag;
char *ct_encoding;
VERSION
This page documents version 1.2 of the Motif library.
DESCRIPTION
XmRegisterSegmentEncoding registers a compound text encoding
format with the specified font list element tag. The
XmCvtXmStringToCT function uses this registry to map the
font list tags of compound string segments to compound text
encoding formats. Registering a font list tag that already
exists in the registry overwrites the original entry. You
can unregister a font list tag by passing a NULL value for
the ct_encoding parameter.
fontlist_tag
Specifies the font list element tag to be registered.
The tag must be a NULL-terminated ISO8859-1 string.
ct_encoding
Specifies the compound text character set to be used
for segments with the font list tag. The value must
be a NULL-terminated ISO8859-1 string. A value of
XmFONTLISTDEFAULTTAG maps the specified font list
tag to the code set of the locale.
RETURN VALUE
Returns NULL for a new font list tag or the old ct_encoding
value for an already registered font list tag. The
application is responsible for freeing the storage
associated with the returned data (if any) by calling
XtFree.
RELATED INFORMATION
XmCvtXmStringToCT(3X), XmFontList(3X),
XmMapSegmentEncoding(3X), and XmString(3X).
Page 1 (printed 4/30/98)