1XmCvtXmStringToCT(library call)                XmCvtXmStringToCT(library call)
2
3
4

NAME

6       XmCvtXmStringToCT — A compound string function that converts a compound
7       string to compound text
8

SYNOPSIS

10       #include <Xm/Xm.h>
11       char * XmCvtXmStringToCT(
12       XmString string);
13

DESCRIPTION

15       XmCvtXmStringToCT converts a compound string to a (char  *)  string  in
16       compound text format.  The application must call XtAppInitialize before
17       calling this function.  The converter uses the font list tag associated
18       with  a  given compound string segment to select a compound text format
19       for that segment.  A registry defines a mapping between font list  tags
20       and  compound  text encoding formats.  The converter uses the following
21       algorithm for each compound string segment:
22
23          1. If   the   compound   string   segment   tag   is    mapped    to
24             XmFONTLIST_DEFAULT_TAG  in the registry, the converter passes the
25             text of the compound string segment to  XmbTextListToTextProperty
26             with an encoding style of XCompoundTextStyle and uses the result‐
27             ing compound text for that segment.
28
29          2. If the compound string segment tag is mapped to an MIT registered
30             charset  in the registry, the converter creates the compound text
31             for that segment using the charset (from the  registry)  and  the
32             text  of  the compound string segment as defined in the X Consor‐
33             tium Standard Compound Text Encoding.
34
35          3. If the compound string segment tag is mapped to a charset in  the
36             registry that is neither XmFONTLIST_DEFAULT_TAG nor an MIT regis‐
37             tered charset, the converter creates the compound text  for  that
38             segment using the charset (from the registry) and the text of the
39             compound string segment as an "extended segment" with a  variable
40             number of octets per character.
41
42          4. If the compound string segment tag is not mapped in the registry,
43             the result is implementation dependent.
44
45       string    Specifies a compound string to be converted to compound text.
46

RETURN

48       Returns a (char *) string in compound  text  format.   This  format  is
49       described  in  the  X  Consortium Standard Compound Text Encoding.  The
50       function allocates space to hold the returned string.  The  application
51       is  responsible  for managing the allocated space.  The application can
52       recover the allocated space by calling XtFree.
53

55       XmCvtCTToXmString(3), XmFontList(3), XmMapSegmentEncoding(3),  XmRegis‐
56       terSegmentEncoding(3), and XmString.
57
58
59
60                                               XmCvtXmStringToCT(library call)
Impressum