Man Linux: Main Page and Category List

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

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(library call)