NAME

       XmFontListEntryCreate   —   A   font   list  function  that  creates  a  font  list  entry
       "XmFontListEntryCreate" "font list functions" "XmFontListEntryCreate"

SYNOPSIS

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

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

                                                                         XmFontListEntryCreate(3)