XmCvtXmStringToCT(3X) OSF/Motif XmCvtXmStringToCT(3X)NAMEXmCvtXmStringToCT - A compound string function that converts a compound
string to compound text
SYNOPSIS
#include <Xm/Xm.h>
char * XmCvtXmStringToCT (string) XmString string;
DESCRIPTIONXmCvtXmStringToCT converts a compound string to a (char *) string in
compound text format. The application must call XtAppInitialize before
calling this function. The converter uses the font list tag associated
with a given compound string segment to select a compound text format
for that segment. A registry defines a mapping between font list tags
and compound text encoding formats. The converter uses the following
algorithm for each compound string segment: If the compound string seg‐
ment tag is mapped to XmFONTLIST_DEFAULT_TAG in the registry, the con‐
verter passes the text of the compound string segment to XmbTextListTo‐
TextProperty with an encoding style of XCompoundTextStyle and uses the
resulting compound text for that segment. If the compound string seg‐
ment tag is mapped to an MIT registered charset in the registry, the
converter creates the compound text for that segment using the charset
(from the registry) and the text of the compound string segment as
defined in the X Consortium Standard Compound Text Encoding. If the
compound string segment tag is mapped to a charset in the registry that
is neither XmFONTLIST_DEFAULT_TAG nor an MIT registered charset, the
converter creates the compound text for that segment using the charset
(from the registry) and the text of the compound string segment as an
"extended segment" with a variable number of octets per character. If
the compound string segment tag is not mapped in the registry, the
result is implementation dependent. Specifies a compound string to be
converted to compound text.
RETURN VALUE
Returns a (char *) string in compound text format. This format is
described in the X Consortium Standard Compound Text Encoding.
RELATED INFORMATIONXmCvtCTToXmString(3X), XmFontList(3X), XmMapSegmentEncoding(3X), XmReg‐
isterSegmentEncoding(3X), and XmString.
XmCvtXmStringToCT(3X)