|s||The string that is to be converted to an XmString.|
An XmString formatted as specified in s.
XmtCreateXmString() converts the string s to an XmString. Where the newline character (\n) appears within s, the resulting XmString will have a line break. Where the font changing sequence @f appears in s, the XmString will switch fonts to the font specified by the characters following the @f sequence.
Three syntaxes for specifying a font are supported, each derived from the troff text formatter. If the font name is a single character, such as B, that character may be specified immediately following the f: @fB. If the font name is two characters long, such as CW, those characters may be specified following an (: @f(CW. Finally, whatever the length of the font name, it may be specified within open and close square brackets following the f: @f[BOLD]. Any font names used in the string s should be defined in the corresponding XmFontList with which the returned XmString will be displayed.
The XmString returned by this function should be freed with XmStringFree() when it is no longer needed. All Motif widgets that accept XmString resources make a copy of that string, so if an XmString is created only so that it may be set on a widget resource, then it may be freed once the widget is created or the resource is set.
Chapter 3, Displaying Text,
|Xmt||XMTCREATEXMSTRING (3)||Motif Tools|