NAME

XmFontListEntryLoad − A font list function that loads a font or creates a font set and creates an accompanying font list entry

SYNOPSIS

#include <Xm/Xm.h>
XmFontListEntry XmFontListEntryLoad (display, font_name, type, tag)

Display*display;
char*font_name;
XmFontTypetype;
char*tag;

DESCRIPTION

XmFontListEntryLoad loads a font or creates a font set based on the value of the type argument.  It creates and returns a font list entry that contains the font or font set and the specified tag. 

If the value of type is XmFONT_IS_FONT, the function uses the XtCvtStringToFontStruct routine to convert the value of font_name to a font struct.  If the value of type is XmFONT_IS_FONTSET, the function uses the XtCvtStringToFontSet converter to create a font set in the current locale.  XmFontListEntryLoad creates a font list entry that contains the font or font set derived from the converter.  For more information about XtCvtStringToFontStruct and XtCvtStringToFontSet, see X Toolkit Intrinsics − C Language Interface.

display
Specifies the display where the font list will be used.

font_name
Specifies an X Logical Font Description (XLFD) string, which is interpreted either as a font name or as a base font name list. A base font name list is a comma-separated and NULL-terminated string.

typeSpecifies whether the font_name argument refers to a font name or to a base font name list.  Valid values are XmFONT_IS_FONT and XmFONT_IS_FONTSET. 

tagSpecifies the tag of the font list entry to be created.  The tag may be specified as XmFONTLIST_DEFAULT_TAG.  XmFONTLIST_DEFAULT_TAG is used to identify the default font list element in a font list when specified as part of a resource. 

RETURN VALUE

If the specified font is not found, or the specified font set can not be created, returns NULL; otherwise, returns a font list entry. 

RELATED INFORMATION

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

Hewlett-Packard Company  —  Motif Release 1.2: May 1992