Provided by: libmotif-dev_2.3.3-5ubuntu1_amd64 bug

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 *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(library call)