DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

XmFontListEntryCreate(Xm)


XmFontListEntryCreate -- a font list function that creates a font list entry

Syntax

#include <Xm/Xm.h>

XmFontListEntry XmFontListEntryCreate (tag, type, font) char *tag; XmFontType type; XtPointer font;

Description

XmFontListEntryCreate creates a font list entry that contains either a font or font set and is identified by a tag.

tag
Specifies a NULL terminated string for the tag of the font list entry. The tag may be specified as XmFONTLIST_DEFAULT_TAG, which is used to identify the default font list element in a font list.

type
Specifies whether the font argument is a font structure or a font set. Valid values are XmFONT_IS_FONT and XmFONT_IS_FONTSET.

font
Specifies either an XFontSet returned by XCreateFontSet or a pointer to an XFontStruct returned by XLoadQueryFont.

The toolkit does not copy the X Font structure specified by the font argument. Therefore, an application programmer must not free XFontStruct or XFontSet until all font lists and/or font entries that reference it have been freed.

Return value

Returns a font list entry.

See also

XmFontList(Xm), XmFontListAppendEntry(Xm), XmFontListEntryFree(Xm), XmFontListEntryGetFont(Xm), XmFontListEntryGetTag(Xm), XmFontListEntryLoad(Xm) and XmFontListRemoveEntry(Xm).
© 2005 The SCO Group, Inc. All rights reserved.
SCO OpenServer Release 6.0.0 -- 26 May 2005