XmFontListEntryCreate(3X)

     NAME
          XmFontListEntryCreate - A font list function that creates a
          font list entry

     SYNOPSIS
          #include <Xm/Xm.h>

          XmFontListEntry XmFontListEntryCreate (tag, type, font)
               char      *tag;
               XmFontTypetype;
               XtPointer font;


     VERSION
          This page documents version 1.2 of the Motif library.

     DESCRIPTION
          XmFontListEntryCreate creates a font list entry that
          contains either a font or font set and is identified by a
          tag.


          tag    Specifies a NULL terminated string for the tag of the
                 font list entry.  The tag may be specified as
                 XmFONTLIST_DEFAULT_TAG, which is used to identify the
                 default font list element in a font list.

          type   Specifies whether the font argument is a font
                 structure or a font set.  Valid values are
                 XmFONT_IS_FONT and XmFONT_IS_FONTSET.

          font   Specifies either an XFontSet returned by
                 XCreateFontSet or a pointer to an XFontStruct
                 returned by XLoadQueryFont.


          The toolkit does not copy the X Font structure specified by
          the font argument.  Therefore, an application programmer
          must not free XFontStruct or XFontSet until all font lists
          and/or font entries that reference it have been freed.

     RETURN VALUE
          Returns a font list entry.

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