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;


VERSION
     This page documents version 1.2 of the Motif library.

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 con-
     tains the font or font set and the specified tag.

     If the value of type  is  XmFONT_IS_FONT,  the  function  uses  the  XtCvt-
     StringToFontStruct  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 XtCvt-
     StringToFontStruct and XtCvtStringToFontSet, see  X  Toolkit  Intrinsics--C
     Language Interface.


     displaySpecifies the display where the font list will be used.

     font_name
            Specifies  an X Logical Font Description (XLFD) string, which is in-
            terpreted 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  Xm-
            FONT_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), Xm-
     FontListEntryFree(3X), XmFontListEntryGetFont(3X), XmFontListEntryGet-
     Tag(3X), and XmFontListRemoveEntry(3X).

                                                         XmFontListEntryLoad(3X)