xmstringcreate(3x) [osf1 man page]

XmStringCreate(3X)														XmStringCreate(3X)

NAME

       XmStringCreate - A compound string function that creates a compound string

SYNOPSIS

       #include <Xm/Xm.h>

       XmString XmStringCreate (text, tag)
	       char *text;
	       char *tag;

DESCRIPTION

       XmStringCreate  creates	a compound string with two components: text and a font list element tag.  Specifies a null-terminated string to be
       used as the text component of the compound string.  Specifies the font list element tag to be associated with the given	text.	The  value
       XmFONTLIST_DEFAULT_TAG identifies a locale text segment.

RETURN VALUE

       Returns a new compound string.

SEE ALSO

       XmFontList(3X),	 XmFontListAdd(3X),   XmFontListAppendEntry(3X),   XmFontListCopy(3X),	 XmFontListCreate(3X),	XmFontListEntryCreate(3X),
       XmFontListEntryFree(3X), XmFontListEntryGetFont(3X), XmFontListEntryGetTag(3X),	XmFontListEntryLoad(3X),  XmFontListFree(3X),  XmFontList-
       FreeFontContext(3X),    XmFontListGetNextFont(3X),   XmFontListInitFontContext(3X),   XmFontListNextEntry(3X),	XmFontListRemoveEntry(3X),
       XmString(3X), XmStringBaseline(3X), XmStringByteCompare(3X), XmStringCompare(3X), XmStringConcat(3X),  XmStringCopy(3X),  XmStringCreateLo-
       calized(3X),   XmStringCreateLtoR(3X),	XmStringCreateSimple(3X),  XmStringDirection(3X),  XmStringDirectionCreate(3X),  XmStringDraw(3X),
       XmStringDrawImage(3X),  XmStringDrawUnderline(3X),  XmStringEmpty(3X),	XmStringExtent(3X),   XmStringFree(3X),   XmStringFreeContext(3X),
       XmStringGetLtoR(3X),  XmStringGetNextComponent(3X), XmStringGetNextSegment(3X), XmStringHasSubstring(3X), XmStringHeight(3X), XmStringInit-
       Context(3X), XmStringLength(3X), XmStringLineCount(3X), XmStringNConcat(3X), XmStringNCopy(3X), XmStringPeekNextComponent(3X), XmStringSeg-
       mentCreate(3X), XmStringSeparatorCreate(3X), XmStringTable(3X), XmStringWidth(3X)

																XmStringCreate(3X)

XmString(library call)													    XmString(library call)

NAME

       XmString -- Data type for a compound string

SYNOPSIS

       #include <Xm/Xm.h>

DESCRIPTION

       XmString  is the data type for a compound string.  Compound strings consist of a sequence of components, including, but not limited to, the
       following:

	  o  XmSTRING_COMPONENT_SEPARATOR

	  o  XmSTRING_COMPONENT_TAB

	  o  XmSTRING_COMPONENT_LAYOUT_POP

	  o  XmSTRING_COMPONENT_DIRECTION

	  o  XmSTRING_COMPONENT_LAYOUT_PUSH

	  o  XmSTRING_COMPONENT_CHARSET

	  o  XmSTRING_COMPONENT_FONTLIST_ELEMENT_TAG

	  o  XmSTRING_COMPONENT_LOCALE

	  o  XmSTRING_COMPONENT_LOCALE_TEXT

	  o  XmSTRING_COMPONENT_TAG

	  o  XmSTRING_COMPONENT_TEXT

	  o  XmSTRING_COMPONENT_END

	  o  XmSTRING_COMPONENT_RENDITION_BEGIN

	  o  XmSTRING_COMPONENT_RENDITION_END

	  o  XmSTRING_COMPONENT_UNKNOWN

	  o  XmSTRING_COMPONENT_WIDECHAR_TEXT

       and also a rendition tags table, text, and text component.  When a compound string is displayed, the rendition tags and the  direction  are
       used to determine how to display the text.

       Calling	XtGetValues for a resource whose type is XmString yields a copy of the compound string resource value.	The application is respon-
       sible for using XmStringFree to free the memory allocated for the copy.

       Please see the XmStringComponentType reference page for more detail about compound string components, and for a description of the order in
       which the components should appear in a compound string.  Refer to the XmRenderTable reference page for a description of the algorithm that
       associates the rendition tags used for displaying a compound string text component with a rendition in a render table.

RELATED

       XmParseMapping(3), XmParseMappingCreate(3), XmParseMappingFree(3), XmParseMappingGetValues(3), XmParseMappingSetValues(3), XmParseTable(3),
       XmParseTableFree(3),  XmStringBaseline(3),  XmStringByteCompare(3),  XmStringByteStreamLength(3), XmStringCompare(3), XmStringComponentCre-
       ate(3), XmStringComponentType(3), XmStringConcat(3),  XmStringConcatAndFree(3),	XmStringCopy(3),  XmStringCreate(3),  XmStringCreateLocal-
       ized(3), XmStringCreateLtoR(3), XmStringCreateSimple(3), XmStringDirection(3), XmStringDirectionCreate(3), XmStringDirectionToDirection(3),
       XmStringDraw(3), XmStringDrawImage(3), XmStringDrawUnderline(3),  XmStringEmpty(3),  XmStringExtent(3),	XmStringFree(3),  XmStringFreeCon-
       text(3),   XmStringGenerate(3),	 XmStringGetLtoR(3),   XmStringGetNextComponent(3),  XmStringGetNextSegment(3),  XmStringGetNextTriple(3),
       XmStringHasSubstring(3), XmStringHeight(3), XmStringInitContext(3), XmStringIsVoid(3), XmStringLength(3), XmStringLineCount(3),	XmStringN-
       Concat(3),   XmStringNCopy(3),	XmStringParseText(3),  XmStringPeekNextComponent(3),  XmStringPeekNextTriple(3),  XmStringPutRendition(3),
       XmStringSegmentCreate(3), XmStringSeparatorCreate(3), XmStringTable(3),	XmStringTableParseStringArray(3),  XmStringTableProposeTablist(3),
       XmStringTableToXmString(3),  XmStringTableUnparse(3),  XmStringToXmStringTable(3),  XmStringUnparse(3),	XmStringWidth(3), XmCvtXmStringTo-
       ByteStream(3), XmCvtXmStringToCT(3), XmCvtCTToXmString(3), and XmCvtByteStreamToXmString(3).

															    XmString(library call)