


XmFontList(3X)						       XmFontList(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmFFoonnttLLiisstt - Data type for a font list

SYNOPSIS


  ##iinncclluuddee <<XXmm//XXmm..hh>>

DESCRIPTION
  XXmmFFoonnttLLiisstt is	the data type for a font list.	A font list consists of	font
  list entries,	each of	which contains a font or a font	set (a group of
  fonts) and is	identified with	a tag.	The font list entry tag	is optional;
  if NULL, the tag is set to XXmmFFOONNTTLLIISSTT__DDEEFFAAUULLTT__TTAAGG. The value of
  XXmmFFOONNTTLLIISSTT__DDEEFFAAUULLTT__TTAAGG is "XmFONTLIST_DEFAULT_TAG_STRING".

  When a compound string is displayed, the font	list element tag of the	com-
  pound	string segment is matched with a font list entry tag in	the font list
  and the matching font	list entry is used to display the compound string.  A
  font list entry is chosen as follows:

    oo++  The first font list entry whose tag matches the tag of the compound
       string segment is used.

    oo++  If no match has been found and if the tag of the	compound string	seg-
       ment is XXmmFFOONNTTLLIISSTT__DDEEFFAAUULLTT__TTAAGG, the first font list entry whose tag
       matches the tag that would result from creating an entry	with
       XXmmSSTTRRIINNGG__DDEEFFAAUULLTT__CCHHAARRSSEETT.  For example, if creating an entry with
       XXmmSSTTRRIINNGG__DDEEFFAAUULLTT__CCHHAARRSSEETT	would result in	the tag	"ISO8859-1", the com-
       pound string segment tag	XXmmFFOONNTTLLIISSTT__DDEEFFAAUULLTT__TTAAGG matches the font	list
       entry tag "ISO8859-1".

    oo++  If no match has been found and if the tag of the	compound string	seg-
       ment matches the	tag that would result from creating a segment with
       XXmmSSTTRRIINNGG__DDEEFFAAUULLTT__CCHHAARRSSEETT, the first font	list entry whose tag is
       XXmmFFOONNTTLLIISSTT__DDEEFFAAUULLTT__TTAAGG is used.

    oo++  If no match has been found, the first entry in the font list is used.

  The font list	interface consists of the routines listed under	"Related
  Information."

  Font lists are specified in resource files using the following syntax:

  _r_e_s_o_u_r_c_e__s_p_e_c::  _f_o_n_t__e_n_t_r_y [ , _f_o_n_t__e_n_t_r_y ]+

  The resource value string consists of	one or more font list entries
  separated by commas.	Each _f_o_n_t__e_n_t_r_y	identifies a font or font set, and an
  optional font	list entry tag.	 A tag specified for a single font follows
  the font name	and is separated by == ;	otherwise, in a	font set the tag is
  separated by a colon.	 The colon is required whether a tag is	specified or
  not.	A font entry uses the following	syntax to specify a single font:

	   _f_o_n_t__n_a_m_e [ '=' _t_a_g ]

  For example, this entry specifies a 10 point Times Italic font without a
  font list entry tag.


  *fontList:  -Adobe-Times-Medium-I-Normal--10*

  A font entry containing a font set is	similar	except a semicolon separates
  multiple font	names and the specification ends with a	colon followed by an
  optional tag.

	    _f_o_n_t__n_a_m_e [	';' _f_o_n_t__n_a_m_e ]+ ':' [ _t_a_g ]

  A _f_o_n_t__n_a_m_e is an X Logical Font Description (XLFD) string and _t_a_g is	any
  set of characters from ISO646IRV except space, comma,	colon, equal sign and
  semicolon.  An example of a font set entry is	given below.  It consists of
  three	fonts (except for charsets), and an explicit font list entry tag.

  *fontList : -Adobe-Courier-Bold-R-Normal--25-180-100-100-M-150;.nL

RELATED	INFORMATION
  XXmmFFoonnttLLiissttAAdddd((33XX)), XXmmFFoonnttLLiissttAAppppeennddEEnnttrryy((33XX)),	XXmmFFoonnttLLiissttCCooppyy((33XX)),
  XXmmFFoonnttLLiissttCCrreeaattee((33XX)),	XXmmFFoonnttLLiissttEEnnttrryyCCrreeaattee((33XX)), XXmmFFoonnttLLiissttEEnnttrryyFFrreeee((33XX)),
  XXmmFFoonnttLLiissttEEnnttrryyGGeettFFoonntt((33XX)), XXmmFFoonnttLLiissttEEnnttrryyGGeettTTaagg((33XX)),
  XXmmFFoonnttLLiissttEEnnttrryyLLooaadd((33XX)), XXmmFFoonnttLLiissttFFrreeee((33XX)), XXmmFFoonnttLLiissttFFrreeeeFFoonnttCCoonntteexxtt((33XX)),
  XXmmFFoonnttLLiissttGGeettNNeexxttFFoonntt((33XX)), XXmmFFoonnttLLiissttIInniittFFoonnttCCoonntteexxtt((33XX)),
  XXmmFFoonnttLLiissttNNeexxttEEnnttrryy((33XX)), XXmmFFoonnttLLiissttRReemmoovveeEEnnttrryy((33XX)), and XXmmSSttrriinngg((33XX)).












































