XmCvtXmStringToCT(3X) XmCvtXmStringToCT(3X)
NAME
XmCvtXmStringToCT - A compound string function that converts a compound string to compound text
SYNOPSIS
#include <Xm/Xm.h>
char * XmCvtXmStringToCT (string)
XmString string;
DESCRIPTION
XmCvtXmStringToCT 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 for-
mat for that segment. A registry defines a mapping between font list tags and compound text encoding formats. The converter uses the fol-
lowing algorithm for each compound string segment: If the compound string segment tag is mapped to XmFONTLIST_DEFAULT_TAG in the registry,
the converter passes the text of the compound string segment to XmbTextListToTextProperty with an encoding style of XCompoundTextStyle and
uses the resulting compound text for that segment. If the compound string segment tag is mapped to an MIT registered charset in the reg-
istry, 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 com-
pound 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.
SEE ALSO
XmCvtCTToXmString(3X), XmFontList(3X), XmMapSegmentEncoding(3X), XmRegisterSegmentEncoding(3X), XmString(3X)
XmCvtXmStringToCT(3X)