XmFontListEntryLoad(3X) — DG/UX R4.11MU05



XmFontListEntryLoad(3X)       SDK X11 R4.11MU05      XmFontListEntryLoad(3X)


NAME
       XmFontListEntryLoad--A font list function that loads a font or
       creates a font set and creates an accompanying font list entry

SYNOPSIS
       #include <Xm/Xm.h>

       XmFontListEntry XmFontListEntryLoad (display, fontname, type, tag)
            Display   *display;
            char      *fontname;
            XmFontTypetype;
            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 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 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.

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


Licensed material--property of copyright holder(s)
Museum
