1XmFontListEntryLoad(library call)            XmFontListEntryLoad(library call)
2
3
4

NAME

6       XmFontListEntryLoad — A font list function that loads a font or creates
7       a font set and creates an accompanying font list entry
8

SYNOPSIS

10       #include <Xm/Xm.h>
11       XmFontListEntry XmFontListEntryLoad(
12       Display *display,
13       char *font_name,
14       XmFontType type,
15       char *tag);
16

DESCRIPTION

18       XmFontListEntryLoad loads a font or creates a font  set  based  on  the
19       value  of  the  type argument. It creates and returns a font list entry
20       that contains the font or font set and the specified tag.
21
22       If the value of type is XmFONT_IS_FONT, the function  uses  the  XtCvt‐
23       StringToFontStruct  routine to convert the value of font_name to a font
24       struct.  If the value of type is XmFONT_IS_FONTSET, the  function  uses
25       the  XtCvtStringToFontSet converter to create a font set in the current
26       locale.  XmFontListEntryLoad creates a font list  entry  that  contains
27       the  font or font set derived from the converter.  For more information
28       about XtCvtStringToFontStruct and XtCvtStringToFontSet, see  X  Toolkit
29       Intrinsics—C Language Interface.
30
31       display   Specifies the display where the font list will be used.
32
33       font_name Specifies  an X Logical Font Description (XLFD) string, which
34                 is interpreted either as a font name or as a base  font  name
35                 list.   A  base font name list is a comma-separated and NULL-
36                 terminated string.
37
38       type      Specifies whether the font_name argument  refers  to  a  font
39                 name  or  to  a  base  font  name  list.   Valid  values  are
40                 XmFONT_IS_FONT and XmFONT_IS_FONTSET.
41
42       tag       Specifies the tag of the font list entry to be created.   The
43                 tag may be specified as XmFONTLIST_DEFAULT_TAG, which is used
44                 to identify the default font list element in a font list when
45                 specified as part of a resource.
46

RETURN

48       If the specified font is not found, or if the specified font set cannot
49       be created, then either an implementation-defined font will  be  opened
50       or  a font set will be created, and a warning messge will be generated.
51       If no suitable font can be found or a font set cannot be created,  then
52       another  message  will  be generated and the function will return NULL;
53       otherwise the function returns a font  list  entry.   If  the  function
54       returns  a  font  list  entry, the function allocates space to hold the
55       font list entry. The application is responsible for managing the  allo‐
56       cated space. The application can recover the allocated space by calling
57       XmFontListEntryFree.
58
60       XmFontList(3),   XmFontListAppendEntry(3),    XmFontListEntryCreate(3),
61       XmFontListEntryFree(3),  XmFontListEntryGetFont(3), XmFontListEntryGet‐
62       Tag(3), and XmFontListRemoveEntry(3).
63
64
65
66                                             XmFontListEntryLoad(library call)
Impressum