XmFontListEntryLoad(3X) 												   XmFontListEntryLoad(3X)

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;
	       XmFontType type;
	       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.  Specifies the display where the
       font list will be used.	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.	Specifies 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.	Specifies 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.

SEE ALSO

       XmFontList(3X), XmFontListAppendEntry(3X), XmFontListEntryCreate(3X),  XmFontListEntryFree(3X),	XmFontListEntryGetFont(3X),  XmFontListEn-
       tryGetTag(3X), XmFontListRemoveEntry(3X)

															   XmFontListEntryLoad(3X)