XmFontListEntryCreate(library call) XmFontListEntryCreate(library call)

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)