XmFontListEntryCreate(library call)     XmFontListEntryCreate(library call)




 NAME    [Toc]    [Back]
      XmFontListEntryCreate - A font list function that creates a font list
      entry

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

 DESCRIPTION    [Toc]    [Back]
      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    [Toc]    [Back]
      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    [Toc]    [Back]
      XmFontList(3), XmFontListAppendEntry(3), XmFontListEntryFree(3),
      XmFontListEntryGetFont(3), XmFontListEntryGetTag(3),
      XmFontListEntryLoad(3), and XmFontListRemoveEntry(3).


                                    - 1 -       Formatted:  January 24, 2005