Museum

 XmFontListEntryLoad(Xm)        6 January 1993        XmFontListEntryLoad(Xm)


 Name

    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 con-
    tains the font or font set and the specified tag.

    If the value of type is XmFONTISFONT, the function uses the
    XtCvtStringToFontStruct routine to convert the value of fontname to a
    font struct.  If the value of type is XmFONTISFONTSET, the function
    uses the XtCvtStringToFontSet converter to create a font set in the
    current locale.  XmFontListEntryLoad creates a font list entry that con-
    tains the font or font set derived from the converter.  For more informa-
    tion about XtCvtStringToFontStruct and XtCvtStringToFontSet, see X
    Toolkit Intrinsics -- C Language Interface.

    display Specifies the display where the font list will be used.

    fontname
            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 fontname argument refers to a font name or
            to a base font name list.  Valid values are XmFONTISFONT and
            XmFONTISFONTSET.

    tag     Specifies the tag of the font list entry to be created.  The tag
            may be specified as XmFONTLISTDEFAULTTAG.  XmFONTLISTDEF-
            AULTTAG 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).