XmFontListEntryLoad(3X) — DG/UX 5.4R3.00



XmFontListEntryLoad(3X)       X11 SDE 5.4R3.00       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, font_name, type, tag)
            Display   *display;      char      *font_name;
            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 XmFONT_IS_FONT, the function uses the
       XtCvtStringToFontStruct routine to convert the value of font_name to
       a font struct.  If the value of type is XmFONT_IS_FONTSET, 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.

        font_name
               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 font_name argument refers to a font
               name or to a base font name list.  Valid values are
               XmFONT_IS_FONT and XmFONT_IS_FONTSET.

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