Museum

 XmFontListEntryCreate(Xm)      6 January 1993      XmFontListEntryCreate(Xm)


 Name

    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 XmFONTLISTDEFAULTTAG, 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 XmFONTISFONT and XmFONTISFONTSET.

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