1XmStringGenerate(library call) XmStringGenerate(library call)
2
6 XmStringGenerate — A convenience function that generates a compound
7 string
8
10 #include <Xm/Xm.h>
11 XmString XmStringGenerate(
12 XtPointer text,
13 XmStringTag tag,
14 XmTextType type,
15 XmStringTag rendition);
16
18 XmStringGenerate calls the XmStringParseText function with a default
19 parse table of entries consisting of '', which maps to Separator, and
20 '', which maps to Tab. Matching RENDITION_BEGIN and RENDITION_END com‐
21 ponents containing rendition are placed around the resulting XmString.
22 text Specifies a NULL-terminated string containing characters of a
24 type determined by type.
25 tag Specifies the tag to be used in creating the result. The type
27 of tag created (charset or locale) depends on the text type
28 and the value given. If specified value is NULL, and type
29 indicates that a charset tag should be created, then the tag
30 will have the value of XmFONTLIST_DEFAULT_TAG. If tag is
31 NULL, and type indicates a locale tag, then the tag will have
32 the value of _MOTIF_DEFAULT_LOCALE.
33 type Specifies the type of text to be passed in, and the tag type.
35 If a locale tag should be created, then type has a value of
36 either XmMULTIBYTE_TEXT or XmWIDECHAR_TEXT. If a charset
37 should be created, type has a value of XmCHARSET_TEXT.
38 rendition Specifies the rendition tag to be used in an XmSTRING_COMPO‐
40 NENT_RENDITION_BEGIN component which will begin the returned
41 string and in an XmSTRING_COMPONENT_RENDITION_END component
42 which will end it. If rendition is NULL, no rendition tag is
43 placed.
44
46 Returns a new compound string. The function will allocate space to
47 hold the returned compound string. When the application no longer
48 needs the returned compound string, the application should call
49 XmStringFree.
50
52 XmString(3) and XmStringFree(3).
53 XmStringGenerate(library call)