XmFontListEntryLoad(3X)
Prev | Reference Pages | Next

## Name

XmFontListEntryLoad(3X) — XmFontListEntryLoad--A font list function that loads a font or creates a font set and creates an accompanying font list entry XmFontListEntryLoadfont list functions

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

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

## RELATED INFORMATION

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

Prev | Table of Contents | Next
XmFontListEntryGetTag(3X) |  | XmFontListFree(3X)