NAME

       XmFontListEntryLoad  —  A  font  list function that loads a font or creates a font set and
       creates an accompanying  font  list  entry  "XmFontListEntryLoad"  "font  list  functions"
       "XmFontListEntryLoad"

SYNOPSIS

       #include <Xm/Xm.h>
       XmFontListEntry XmFontListEntryLoad(
       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 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, which is used to identify the default font
                 list element in a font list when specified as part of a resource.

RETURN

       If the specified font is not found, or if the specified font set cannot be  created,  then
       either  an implementation-defined font will be opened or a font set will be created, and a
       warning messge will be generated. If no suitable font can be found or a font set cannot be
       created,  then  another  message  will  be  generated  and  the function will return NULL;
       otherwise the function returns a font list entry.  If the function  returns  a  font  list
       entry,  the  function  allocates  space  to  hold  the font list entry. The application is
       responsible for managing the allocated space. The application can  recover  the  allocated
       space by calling XmFontListEntryFree.

RELATED

       XmFontList(3), XmFontListAppendEntry(3), XmFontListEntryCreate(3), XmFontListEntryFree(3),
       XmFontListEntryGetFont(3), XmFontListEntryGetTag(3), and XmFontListRemoveEntry(3).

                                                                           XmFontListEntryLoad(3)