NAME
XmStringGenerate — A convenience function that generates a compound
string
SYNOPSIS
#include <Xm/Xm.h>
XmString XmStringGenerate(
XtPointer text,
XmStringTag tag,
XmTextType type,
XmStringTag rendition);
DESCRIPTION
XmStringGenerate calls the XmStringParseText function with a default
parse table of entries consisting of ’’, which maps to Separator, and
’’, which maps to Tab. Matching RENDITION_BEGIN and RENDITION_END
components containing rendition are placed around the resulting
XmString.
text Specifies a NULL-terminated string containing characters of a
type determined by type.
tag Specifies the tag to be used in creating the result. The type
of tag created (charset or locale) depends on the text type
and the value given. If specified value is NULL, and type
indicates that a charset tag should be created, then the tag
will have the value of XmFONTLIST_DEFAULT_TAG. If tag is
NULL, and type indicates a locale tag, then the tag will have
the value of _MOTIF_DEFAULT_LOCALE.
type Specifies the type of text to be passed in, and the tag type.
If a locale tag should be created, then type has a value of
either XmMULTIBYTE_TEXT or XmWIDECHAR_TEXT. If a charset
should be created, type has a value of XmCHARSET_TEXT.
rendition Specifies the rendition tag to be used in an
XmSTRING_COMPONENT_RENDITION_BEGIN component which will begin
the returned string and in an
XmSTRING_COMPONENT_RENDITION_END component which will end it.
If rendition is NULL, no rendition tag is placed.
RETURN
Returns a new compound string. The function will allocate space to
hold the returned compound string. When the application no longer
needs the returned compound string, the application should call
XmStringFree.
RELATED
XmString(3) and XmStringFree(3).
XmStringGenerate(library call)