DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH
 

XmFontListEntryLoad(Xm)


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

Syntax

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


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.

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

tag
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(Xm), XmFontListAppendEntry(Xm),
XmFontListEntryCreate(Xm), XmFontListEntryFree(Xm),
XmFontListEntryGetFont(Xm), XmFontListEntryGetTag(Xm) and
XmFontListRemoveEntry(Xm).
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003