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)