XmFontListEntryLoad(3X)



     XmFontListEntryLoad(3X)   UNIX System V   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 XmFONTISFONT, the function uses
          the XtCvtStringToFontStruct routine to convert the value of
          font_name to a font struct.  If the value of type is
          XmFONTISFONTSET, 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 XmFONTISFONT and XmFONTISFONTSET.

          tag    Specifies the tag of the font list entry to be
                 created.  The tag may be specified as
                 XmFONTLISTDEFAULTTAG.  XmFONTLISTDEFAULTTAG is



     Page 1                                          (printed 4/30/98)



     XmFontListEntryLoad(3X)   UNIX System V   XmFontListEntryLoad(3X)



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









































     Page 2                                          (printed 4/30/98)

Museum