CentOS 7.0 - man page for xmfontlistentryload (centos section 3)

XmFontListEntryLoad(library call)						    XmFontListEntryLoad(library call)

NAME
       XmFontListEntryLoad  -- A font list function that loads a font or creates a font set and creates an accompany-
       ing 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  XtCvt-
       StringToFontSet 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.

       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 implementa-
       tion-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 man-
       aging the allocated space. The application can recover the allocated space by calling XmFontListEntryFree.

RELATED
       XmFontList(3), XmFontListAppendEntry(3), XmFontListEntryCreate(3), XmFontListEntryFree(3), XmFontListEntryGet-
       Font(3), XmFontListEntryGetTag(3), and XmFontListRemoveEntry(3).

										    XmFontListEntryLoad(library call)