XmString(3X)

     NAME
          XmString - Data type for a compound string

     SYNOPSIS
          #include <Xm/Xm.h>

     VERSION
          This page documents Motif 2.1.

     DESCRIPTION
          XmStringis 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 responsible 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), XmStringComponentCreate(3),
          XmStringComponentType(3), XmStringConcat(3),
          XmStringConcatAndFree(3), XmStringCopy(3),
          XmStringCreate(3), XmStringCreateLocalized(3),
          XmStringCreateLtoR(3), XmStringCreateSimple(3),
          XmStringDirection(3), XmStringDirectionCreate(3),
          XmStringDirectionToDirection(3), XmStringDraw(3),
          XmStringDrawImage(3), XmStringDrawUnderline(3),
          XmStringEmpty(3), XmStringExtent(3), XmStringFree(3),
          XmStringFreeContext(3), XmStringGenerate(3),
          XmStringGetLtoR(3), XmStringGetNextComponent(3),
          XmStringGetNextSegment(3), XmStringGetNextTriple(3),
          XmStringHasSubstring(3), XmStringHeight(3),
          XmStringInitContext(3), XmStringIsVoid(3),
          XmStringLength(3), XmStringLineCount(3), XmStringNConcat(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),
          XmCvtXmStringToByteStream(3), XmCvtXmStringToCT(3),
          XmCvtCTToXmString(3), and XmCvtByteStreamToXmString(3).