Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XmtCreateXmString(3)	    Library Functions Manual	    XmtCreateXmString(3)

NAME
     XmtCreateXmString() - create a multi-line, multi-font Xm String.

SYNOPSIS
     #include <Xmt/Xmt.h>

     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 new-
     line character ('\n') appears within s, the resulting XmString will have  a
     line  break.  Where the font changing sequence ``@f'' appears in s, the Xm-
     String 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  re-
     sources  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 wid-
     get is created or the resource is set.

SEE ALSO
     Chapter 3, Displaying Text,
     XmStringFree(), XmtRegisterXmStringConverter().

Xmt				   Motif Tools		    XmtCreateXmString(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XmtCreateXmString&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help