XmFontLi(Xm) — OpenDesktop Software Development System 3.0.0


 XmFontList(Xm)                 6 January 1993                 XmFontList(Xm)


 Name

    XmFontList - data type for a font list

 Syntax


    #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 XmFONTLISTDEFAULTTAG.  The value of
    XmFONTLISTDEFAULTTAG is XmFONTLISTDEFAULTTAGSTRING.

    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 seg-
       ment is XmFONTLISTDEFAULTTAG, the first font list entry whose tag
       matches the tag that would result from creating an entry with
       XmSTRINGDEFAULTCHARSET.  For example, if creating an entry with
       XmSTRINGDEFAULTCHARSET would result in the tag ``ISO8859-1'', the
       compound string segment tag XmFONTLISTDEFAULTTAG matches the font
       list entry tag ``ISO8859-1''.

    +  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
       XmSTRINGDEFAULTCHARSET, the first font list entry whose tag is
       XmFONTLISTDEFAULTTAG 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 the ``See
    also'' section.

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

       resourcespec: fontentry [ , fontentry ]+

    The resource value string consists of one or more font list entries
    separated by commas. Each fontentry 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 ``=''; 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:

       fontname [ = 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.

       fontname [ ; fontname ]+ : [ tag ]

    A fontname 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;\
       -JIS-Fixed-Medium-R-Normal--26-180-100-100-C-240;\
       -JIS-Fixed-Medium-R-Normal--26-180-100-100-C-120:MY_TAG


 See also

    XmFontListAdd(Xm), XmFontListAppendEntry(Xm), XmFontListCopy(Xm),
    XmFontListCreate(Xm), XmFontListEntryCreate(Xm), XmFontListEntryFree(Xm),
    XmFontListEntryGetFont(Xm), XmFontListEntryGetTag(Xm),
    XmFontListEntryLoad(Xm), XmFontListFree(Xm),
    XmFontListFreeFontContext(Xm), XmFontListGetNextFont(Xm),
    XmFontListInitFontContext(Xm), XmFontListNextEntry(Xm),
    XmFontListRemoveEntry(Xm) and XmString(Xm).
Museum
