1XmFontListEntryLoad(library call) XmFontListEntryLoad(library call)
2
3
4
6 XmFontListEntryLoad — A font list function that loads a font or creates
7 a font set and creates an accompanying font list entry
8
10 #include <Xm/Xm.h>
11 XmFontListEntry XmFontListEntryLoad(
12 Display *display,
13 char *font_name,
14 XmFontType type,
15 char *tag);
16
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
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)