Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
XmFontListEntryLoad(3)	   Library Functions Manual	XmFontListEntryLoad(3)

       XmFontListEntryLoad  --	A font list function that loads	a font or cre-
       ates a font set and creates an accompanying font	list entry

       #include	<Xm/Xm.h>
       XmFontListEntry XmFontListEntryLoad(
       Display *display,
       char *font_name,
       XmFontType type,
       char *tag);

       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	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 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 Xm-

       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.

       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  re-
       turns  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 Xm-

       XmFontList(3), XmFontListAppendEntry(3),	XmFontListEntryCreate(3),  Xm-
       FontListEntryFree(3),   XmFontListEntryGetFont(3),  XmFontListEntryGet-
       Tag(3), and XmFontListRemoveEntry(3).



Want to link to this manual page? Use this URL:

home | help