1XmString(library call) XmString(library call)
2
3
4
6 XmString — Data type for a compound string
7
9 #include <Xm/Xm.h>
10
12 XmString is the data type for a compound string. Compound strings con‐
13 sist of a sequence of components, including, but not limited to, the
14 following:
15
16 · XmSTRING_COMPONENT_SEPARATOR
17
18 · XmSTRING_COMPONENT_TAB
19
20 · XmSTRING_COMPONENT_LAYOUT_POP
21
22 · XmSTRING_COMPONENT_DIRECTION
23
24 · XmSTRING_COMPONENT_LAYOUT_PUSH
25
26 · XmSTRING_COMPONENT_CHARSET
27
28 · XmSTRING_COMPONENT_FONTLIST_ELEMENT_TAG
29
30 · XmSTRING_COMPONENT_LOCALE
31
32 · XmSTRING_COMPONENT_LOCALE_TEXT
33
34 · XmSTRING_COMPONENT_TAG
35
36 · XmSTRING_COMPONENT_TEXT
37
38 · XmSTRING_COMPONENT_END
39
40 · XmSTRING_COMPONENT_RENDITION_BEGIN
41
42 · XmSTRING_COMPONENT_RENDITION_END
43
44 · XmSTRING_COMPONENT_UNKNOWN
45
46 · XmSTRING_COMPONENT_WIDECHAR_TEXT
47
48 and also a rendition tags table, text, and text component. When a com‐
49 pound string is displayed, the rendition tags and the direction are
50 used to determine how to display the text.
51
52 Calling XtGetValues for a resource whose type is XmString yields a copy
53 of the compound string resource value. The application is responsible
54 for using XmStringFree to free the memory allocated for the copy.
55
56 Please see the XmStringComponentType reference page for more detail
57 about compound string components, and for a description of the order in
58 which the components should appear in a compound string. Refer to the
59 XmRenderTable reference page for a description of the algorithm that
60 associates the rendition tags used for displaying a compound string
61 text component with a rendition in a render table.
62
64 XmParseMapping(3), XmParseMappingCreate(3), XmParseMappingFree(3),
65 XmParseMappingGetValues(3), XmParseMappingSetValues(3),
66 XmParseTable(3), XmParseTableFree(3), XmStringBaseline(3), XmString‐
67 ByteCompare(3), XmStringByteStreamLength(3), XmStringCompare(3),
68 XmStringComponentCreate(3), XmStringComponentType(3), XmStringCon‐
69 cat(3), XmStringConcatAndFree(3), XmStringCopy(3), XmStringCreate(3),
70 XmStringCreateLocalized(3), XmStringCreateLtoR(3), XmStringCreateSim‐
71 ple(3), XmStringDirection(3), XmStringDirectionCreate(3), XmStringDi‐
72 rectionToDirection(3), XmStringDraw(3), XmStringDrawImage(3), XmString‐
73 DrawUnderline(3), XmStringEmpty(3), XmStringExtent(3), XmStringFree(3),
74 XmStringFreeContext(3), XmStringGenerate(3), XmStringGetLtoR(3),
75 XmStringGetNextComponent(3), XmStringGetNextSegment(3), XmStringGet‐
76 NextTriple(3), XmStringHasSubstring(3), XmStringHeight(3),
77 XmStringInitContext(3), XmStringIsVoid(3), XmStringLength(3), XmString‐
78 LineCount(3), XmStringNConcat(3), XmStringNCopy(3), XmStringParse‐
79 Text(3), XmStringPeekNextComponent(3), XmStringPeekNextTriple(3),
80 XmStringPutRendition(3), XmStringSegmentCreate(3), XmStringSeparator‐
81 Create(3), XmStringTable(3), XmStringTableParseStringArray(3),
82 XmStringTableProposeTablist(3), XmStringTableToXmString(3),
83 XmStringTableUnparse(3), XmStringToXmStringTable(3), XmStringUn‐
84 parse(3), XmStringWidth(3), XmCvtXmStringToByteStream(3), XmCvtXm‐
85 StringToCT(3), XmCvtCTToXmString(3), and XmCvtByteStreamToXmString(3).
86
87
88
89 XmString(library call)