NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

       #include <Xm/Xm.h>

       XmFontListEntry XmFontListEntryCreate (tag, type, font)
               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.  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.  Specifies
       whether the font argument is a font structure  or  a  font
       set.      Valid     values    are    XmFONT_IS_FONT    and
       XmFONT_IS_FONTSET.  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    [Toc]    [Back]

       Returns a font list entry.

SEE ALSO    [Toc]    [Back]

       XmFontList(3X),  XmFontListAppendEntry(3X),  XmFontListEntryFree(3X),   XmFontListEntryGetFont(3X),   XmFontListEntryGetTag(3X),                    XmFontListEntryLoad(3X),
       XmFontListRemoveEntry(3X)



                                        XmFontListEntryCreate(3X)