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

FreeBSD Manual Pages

  
 
  

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

NAME
       XmFontList -- Data type for a font list

SYNOPSIS
       #include	<Xm/Xm.h>

DESCRIPTION
       XmFontList  is  the  data type for a font list. A font list consists of
       font list entries. Each entry contains a	font or	a font set (a group of
       fonts) and is identified	with a tag, which is optional. If this tag  is
       NULL, the tag is	set to XmFONTLIST_DEFAULT_TAG.

       The value of XmFONTLIST_DEFAULT_TAG is XmFONTLIST_DEFAULT_TAG_STRING.

       When  a	compound string	is displayed, the font list element tag	of the
       compound	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 com-
       pound string. A font list entry is chosen as follows:

	    The first font list entry whose tag matches the tag of  the  com-
	     pound string segment is used.

	    If	 no match has been found and if	the tag	of the compound	string
	     segment is	XmFONTLIST_DEFAULT_TAG,	 the  first  font  list	 entry
	     whose  tag	matches	the tag	that would result from creating	an en-
	     try with XmSTRING_DEFAULT_CHARSET is used.	 For example, if  cre-
	     ating  an entry with XmSTRING_DEFAULT_CHARSET would result	in the
	     tag ISO8859-1, the	compound  string  segment  tag	XmFONTLIST_DE-
	     FAULT_TAG matches the font	list entry tag ISO8859-1.

	    If	 no match has been found and if	the tag	of the compound	string
	     segment matches the tag that would	result from creating a segment
	     with XmSTRING_DEFAULT_CHARSET, the	first font  list  entry	 whose
	     tag is XmFONTLIST_DEFAULT_TAG is used.

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

       The font	list interface consists	of the routines	listed in Related  In-
       formation.

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

       resource_spec:  font_entry [, font_entry	]+

       The  resource  value  string  consists of one or	more font list entries
       separated by commas. Each font_entry identifies a font or font set  and
       an optional font	list entry tag.	A tag specified	for a single font fol-
       lows the	font name and is separated by =	(equals	sign); 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:

       font_name [ '=' tag ]

       For example, the	following 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 sepa-
       rates multiple font names and the specification ends with a colon  fol-
       lowed by	an optional tag:

       font_name [ ';' font_name ]+ ':'	[ tag ]

       A  font_name  is	an X Logical Font Description (XLFD) string and	tag is
       any set of characters from ISO646IRV except space, comma, colon,	 equal
       sign  and  semicolon.  Following	 is an example of a font set entry. 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;-JIS-Fixed-Medium-R-Normal--26-180-100-100-C-240;-JIS-Fixed-Medium-R-Normal--26-180-100-100-C-120:MY_TAG

       Note  that  the XmRenderTable is	another	data type that can be used for
       font lists. Refer to the	XmRenderTable(3) for details.

RELATED
       XmFontListAdd(3),  XmFontListAppendEntry(3),   XmFontListCopy(3),   Xm-
       FontListCreate(3),   XmFontListEntryCreate(3),  XmFontListEntryFree(3),
       XmFontListEntryGetFont(3),  XmFontListEntryGetTag(3),  XmFontListEntry-
       Load(3),	 XmFontListFree(3),  XmFontListFreeFontContext(3), XmFontList-
       GetNextFont(3),	XmFontListInitFontContext(3),  XmFontListNextEntry(3),
       XmFontListRemoveEntry(3), XmRenderTable(3), and XmString(3).

								 XmFontList(3)

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

home | help