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

NAME

6       XmStringTableUnparse  — A convenience function that converts a table of
7       compound strings to an array of text
8

SYNOPSIS

10       #include <Xm/Xm.h>
11       XtPointer * XmStringTableUnparse(
12       XmStringTable table,
13       Cardinal count,
14       XmStringTag tag,
15       XmTextType tag_type,
16       XmTextType output_type,
17       XmParseTable parse,
18       Cardinal parse_count,
19       XmParseModel parse_model);
20

DESCRIPTION

22       XmStringTableUnparse takes an array of compound  strings,  allocates  a
23       string  array  for  the  type  of characters determined by type with an
24       equal number of slots, calls XmStringUnparse on each compound string in
25       table,  and  inserts  the resulting string in the corresponding slot in
26       the array.
27
28       table     Specifies an XmStringTable containing the compound string  to
29                 be converted.
30
31       count     Specifies the number of compound strings in table.
32
33       tag       Specifies  the tag to be used in matching with text segments.
34                 The two types of tag  types  are  XmFONTLIST_DEFAULT_TAG  and
35                 _MOTIF_DEFAULT_LOCALE.  Only segments tagged with tag will be
36                 returned. If tag is NULL, all segments will be matched.
37
38       tag_type  Specifies the type of tag to be  searched  for.  These  types
39                 include      XmMULTIBYTE_TEXT,      XmWIDECHAR_TEXT,      and
40                 XmCHARSET_TEXT.
41
42       output_type
43                 Specifies the type of  text  to  be  generated.  These  types
44                 include      XmMULTIBYTE_TEXT,      XmWIDECHAR_TEXT,      and
45                 XmCHARSET_TEXT.
46
47       parse     Specifies the parse table to be used.
48
49       parse_count
50                 Specifies the number of items in parse.
51
52       parse_model
53                 Specifies which  non-text  components  to  be  considered  in
54                 matching in parse_table. Possible values are:
55
56                 XmOUTPUT_ALL
57                           Puts out all matching components.
58
59                 XmOUTPUT_BETWEEN
60                           Puts  out  only  those matching components that are
61                           between two matching text components.
62
63                 XmOUTPUT_BEGINNING
64                           Puts out only those matching components that are at
65                           the beginning of a matching text component.
66
67                 XmOUTPUT_END
68                           Puts out only those matching components that are at
69                           the end of a matching text component.
70
71                 XmOUTPUT_BOTH
72                           Puts out only those matching components that are at
73                           the beginning or end of a matching text component.
74

RETURN

76       Returns  an  allocated  array of allocated strings.  The application is
77       responsible for managing the  allocated  space.   The  application  can
78       recover the allocated strings space by calling XtFree count times (that
79       is, one time for each allocated  string).   The  application  can  then
80       recover  the  allocated  array by calling XtFree on the allocated array
81       itself.
82
84       XmStringTab.
85
86
87
88                                            XmStringTableUnparse(library call)
Impressum