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