XmFontListEntryLoad(3X)

     NAME
          XmFontListEntryLoad - A font list function that loads a font
          or creates a font set and creates an accompanying font list
          entry

     SYNOPSIS
          #include <Xm/Xm.h>

          XmFontListEntry XmFontListEntryLoad (display, font_name, type, tag)
               Display   *display;
               char      *font_name;
               XmFontTypetype;
               char      *tag;


     VERSION
          This page documents version 1.2 of the Motif library.

     DESCRIPTION
          XmFontListEntryLoad loads a font or creates a font set based
          on the value of the type argument.  It creates and returns a
          font list entry that contains the font or font set and the
          specified tag.

          If the value of type is XmFONT_IS_FONT, the function uses
          the XtCvtStringToFontStruct routine to convert the value of
          font_name to a font struct.  If the value of type is
          XmFONT_IS_FONTSET, the function uses the
          XtCvtStringToFontSet converter to create a font set in the
          current locale.  XmFontListEntryLoad creates a font list
          entry that contains the font or font set derived from the
          converter.  For more information about
          XtCvtStringToFontStruct and XtCvtStringToFontSet, see X
          Toolkit Intrinsics-C Language Interface.


          displaySpecifies the display where the font list will be
                 used.

          font_name
                 Specifies an X Logical Font Description (XLFD)
                 string, which is interpreted either as a font name or
                 as a base font name list. A base font name list is a
                 comma-separated and NULL-terminated string.

          type   Specifies whether the font_name argument refers to a
                 font name or to a base font name list.  Valid values
                 are XmFONT_IS_FONT and XmFONT_IS_FONTSET.

          tag    Specifies the tag of the font list entry to be
                 created.  The tag may be specified as
                 XmFONTLIST_DEFAULT_TAG.  XmFONTLIST_DEFAULT_TAG is
                 used to identify the default font list element in a
                 font list when specified as part of a resource.


     RETURN VALUE
          If the specified font is not found, or the specified font
          set can not be created, returns NULL; otherwise, returns a
          font list entry.

     RELATED INFORMATION
          XmFontList(3X), XmFontListAppendEntry(3X),
          XmFontListEntryCreate(3X), XmFontListEntryFree(3X),
          XmFontListEntryGetFont(3X), XmFontListEntryGetTag(3X), and
          XmFontListRemoveEntry(3X).