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

NAME

6       XmStringGenerate  —  A  convenience  function that generates a compound
7       string
8

SYNOPSIS

10       #include <Xm/Xm.h>
11       XmString XmStringGenerate(
12       XtPointer text,
13       XmStringTag tag,
14       XmTextType type,
15       XmStringTag rendition);
16

DESCRIPTION

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
23       text      Specifies a NULL-terminated string containing characters of a
24                 type determined by type.
25
26       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
34       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
39       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

RETURN

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
54
55
56                                                XmStringGenerate(library call)
Impressum