XmStringTableUnparse(library call) XmStringTableUnparse(library call)
NAME [Toc] [Back]
XmStringTableUnparse - A convenience function that converts a table of
compound strings to an array of text
SYNOPSIS [Toc] [Back]
#include <Xm/Xm.h>
XtPointer * XmStringTableUnparse(
XmStringTable table,
Cardinal count,
XmStringTag tag,
XmTextType tag_type,
XmTextType output_type,
XmParseTable parse,
Cardinal parse_count,
XmParseModel parse_model);
DESCRIPTION [Toc] [Back]
XmStringTableUnparse takes an array of compound strings, allocates a
string array for the type of characters determined by type with an
equal number of slots, calls XmStringUnparse on each compound string
in table, and inserts the resulting string in the corresponding slot
in the array.
table Specifies an XmStringTable containing the compound string to
be converted.
count Specifies the number of compound strings in table.
tag Specifies the tag to be used in matching with text segments.
The two types of tag types are XmFONTLIST_DEFAULT_TAG and
_MOTIF_DEFAULT_LOCALE. Only segments tagged with tag will
be returned. If tag is NULL, all segments will be matched.
tag_type Specifies the type of tag to be searched for. These types
include XmMULTIBYTE_TEXT, XmWIDECHAR_TEXT, and
XmCHARSET_TEXT.
output_type
Specifies the type of text to be generated. These types
include XmMULTIBYTE_TEXT, XmWIDECHAR_TEXT, and
XmCHARSET_TEXT.
parse Specifies the parse table to be used.
parse_count
Specifies the number of items in parse.
parse_model
Specifies which non-text components to be considered in
matching in parse_table. Possible values are:
- 1 - Formatted: January 24, 2005
XmStringTableUnparse(library call) XmStringTableUnparse(library call)
XmOUTPUT_ALL [Toc] [Back]
Puts out all matching components.
XmOUTPUT_BETWEEN [Toc] [Back]
Puts out only those matching components that are
between two matching text components.
XmOUTPUT_BEGINNING [Toc] [Back]
Puts out only those matching components that are
at the beginning of a matching text component.
XmOUTPUT_END [Toc] [Back]
Puts out only those matching components that are
at the end of a matching text component.
XmOUTPUT_BOTH [Toc] [Back]
Puts out only those matching components that are
at the beginning or end of a matching text
component.
RETURN [Toc] [Back]
Returns an allocated array of allocated strings. The application is
responsible for managing the allocated space. The application can
recover the allocated strings space by calling XtFree count times
(that is, one time for each allocated string). The application can
then recover the allocated array by calling XtFree on the allocated
array itself.
RELATED [Toc] [Back]
XmStringTab.
- 2 - Formatted: January 24, 2005 [ Back ] |
