|
Unix VPS
Support
FAQ
Network
Miscellaneous
|
| XmtCreateXmString(3) | FreeBSD Library Functions Manual | XmtCreateXmString(3) |
NAME
XmtCreateXmString() - create a multi-line, multi-font Xm String.SYNOPSIS
XmString XmtCreateXmString(String s)
ARGUMENTS
INPUTS- s
- The string that is to be converted to an XmString.
RETURNS
An XmString formatted as specified in s.
DESCRIPTION
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.
SEE ALSO
Chapter 3, Displaying Text,XmStringFree(), XmtRegisterXmStringConverter().
| Motif Tools | Xmt |
Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.