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

DESCRIPTION

XmFontListEntryCreate creates a font list entry that contains either a font or font set and is identified by a tag. 

tagSpecifies 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. 

typeSpecifies whether the font argument is a font structure or a font set.  Valid values are XmFONT_IS_FONT and XmFONT_IS_FONTSET. 

fontSpecifies 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

Returns a font list entry. 

RELATED INFORMATION

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

Hewlett-Packard Company  —  Motif Release 1.2: May 1992