NAME

XmFontListCreate — a compound string function that creates a font list.

SYNOPSIS

#include <Xm/Xm.h> XmFontList XmFontListCreate (font, charset)
XFontStruct∗ font;
XmStringCharSet charset;

DESCRIPTION

XmFontListCreate creates a new font list with a single element specified by the provided font and character set.  It also allocates the space for the font list. 

fontSpecifies a pointer to a font structure for which the new font list is generated.  This is the structure returned by the XLib XLoadQueryFont function. 

charsetSpecifies the character set identifier for the font.  This can be XmSTRING_DEFAULT_CHARSET, but this value does not comply with the AES, and it may be removed in future versions of Motif.  If the value is XmSTRING_DEFAULT_CHARSET, the routine derives the character set from the current language environment. 

RETURN VALUE

Returns NULL if font or charset is NULL; otherwise, returns a new font list. 

RELATED INFORMATION

XmFontList(3X), XmFontListAdd(3X), XmFontListCopy(3X), XmFontListFree(3X), XmFontListFreeFontContext(3X), XmFontListGetNextFont(3X), XmFontListInitFontContext(3X), XmString(3X), XmStringBaseline(3X), XmStringByteCompare(3X), XmStringCompare(3X), XmStringConcat(3X), XmStringCopy(3X), XmStringCreate(3X), XmStringCreateLtoR(3X), XmStringCreateSimple(3X), XmStringDirectionCreate(3X), XmStringDraw(3X), XmStringDrawImage(3X), XmStringDrawUnderline(3X), XmStringEmpty(3X), XmStringExtent(3X), XmStringFree(3X), XmStringFreeContext(3X), XmStringGetLtoR(3X), XmStringGetNextComponent(3X), XmStringGetNextSegment(3X), XmStringHasSubstring(3X), XmStringHeight(3X), XmStringInitContext(3X), XmStringLength(3X), XmStringLineCount(3X), XmStringNConcat(3X), XmStringNCopy(3X), XmStringPeekNextComponent(3X), XmStringSegmentCreate(3X), XmStringSeparatorCreate(3X), XmStringTable(3X), and XmStringWidth(3X). 

September 02, 1992