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 en-
            try.  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  argu-
     ment.   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), Xm-
     FontListEntryGetFont(3X), XmFontListEntryGetTag(3X), XmFontListEntry-
     Load(3X), and XmFontListRemoveEntry(3X).

                                                       XmFontListEntryCreate(3X)