home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat3 / Tm / tmstring.z / tmstring
Encoding:
Text File  |  2002-10-03  |  2.6 KB  |  67 lines
  1.  
  2.  
  3.  
  4. TTTTmmmmSSSSttttrrrriiiinnnngggg((((3333TTTTmmmm))))                                                    TTTTmmmmSSSSttttrrrriiiinnnngggg((((3333TTTTmmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      TTTTmmmmSSSSttttrrrriiiinnnngggg - the string to XmString conversion
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      This section describes the way strings are converted to XmStrings.
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      Motif uses a data type known as XmString. This is a compound string
  16.      format, containing rendition information such as direction and font.
  17.      XmStrings are used in a number of places, most notably in the label of a
  18.      Label widget.
  19.  
  20.      In the conversion of a string to an XmString, the following format rules
  21.      are applied:
  22.  
  23.      The string is treated as a list of words.
  24.  
  25.      Words in the list are concatenated with a single space between them, no
  26.      matter what the original white space between them.
  27.  
  28.      Individual words may be quoted either by quotes "..." or brackets {...}.
  29.      White space within a quoted word is preserved, but the quote marks or
  30.      brackets are discarded.
  31.  
  32.      If a word begins with the character '@' then it is treated as a control
  33.      word for the formatting.  @n places a newline component in the XmString.
  34.      @L or @l places a left-to-right component in the XmString.  @R or @r
  35.      places a right-to-left component in the XmString.  @f_X places a  font
  36.      component in the XmString, where the single character _X is the font tag.
  37.      @f(_X_Y places a  font component in the XmString, where the two character
  38.      _X_Y is the font tag.  @F{_f_o_n_t-_t_a_g} places a  font component in the
  39.      XmString, where _f_o_n_t-_t_a_g is the font tag of any length.
  40.  
  41.      The font tag is matched with a font as specified in the fontList of the
  42.      widget that the XmString is rendered in. The fontList is a list of _f_o_n_t-
  43.      _n_a_m_e=_f_o_n_t-_t_a_g specifiers separated by commas.
  44.  
  45.      Example
  46.       .label setValues \
  47.           -fontList "9x15=R, 9x15bold=bold" \
  48.           -labelString "ordinary @r right-to-left @f{bold}
  49.                         right-to-left bold text
  50.                         @fR @l ordinary font, left to right"
  51.  
  52. BBBBUUUUGGGGSSSS
  53.      None known.
  54.  
  55. AAAAUUUUTTTTHHHHOOOORRRR
  56.      Jan Newmarch, University of Canberra
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.