XmFontListEntryCreate(3X)

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

     SYNOPSIS
          #include <Xm/Xm.h>
          XmFontListEntry XmFontListEntryCreate(
          char *tag,
          XmFontType type,
          XtPointer font);

     VERSION
          This page documents Motif 2.1.

     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
          Returns a font list entry.  The function allocates space to
          hold the returned font list entry. The application is
          responsible for managing the allocated space. The
          application can recover the allocated space by calling
          XmFontListEntryFree.

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