Index Index for
Section 3X
Index Alphabetical
listing for X
Bottom of page Bottom of
page		 

XmFontList(3X)


OSF/Motif


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 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 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 compound
  string.  A font list entry is chosen as follows:

    ·  The first font list entry whose tag matches the tag of the compound
       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 entry with
       XmSTRING_DEFAULT_CHARSET. For example, if creating an entry with
       XmSTRING_DEFAULT_CHARSET would result in the tag "ISO8859-1", the
       compound string segment tag XmFONTLIST_DEFAULT_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 under SEE ALSO.

  Font lists are specified in resource files using 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 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:

  font_name [ '=' tag ]

  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.

  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.  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


SEE ALSO

  XmFontListAdd(3X), XmFontListAppendEntry(3X), XmFontListCopy(3X),
  XmFontListCreate(3X), XmFontListEntryCreate(3X), XmFontListEntryFree(3X),
  XmFontListEntryGetFont(3X), XmFontListEntryGetTag(3X),
  XmFontListEntryLoad(3X), XmFontListFree(3X), XmFontListFreeFontContext(3X),
  XmFontListGetNextFont(3X), XmFontListInitFontContext(3X),
  XmFontListNextEntry(3X), XmFontListRemoveEntry(3X), XmString(3X)

Index Index for
Section 3X
Index Alphabetical
listing for X
Top of page Top of
page