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