XListFonts() XListFonts()
Name
XListFonts - return a list of the available font names.
Synopsis
char **XListFonts(display, pattern, maxnames, actual_count_return)
Display *display;
char *pattern;
int maxnames;
int *actual_count_return;
Arguments
display Specifies a connection to an X server; returned from XOpenDisplay().
pattern Specifies the string associated with the font names you want returned. You can specify any string, including asterisks (*) and
question marks (?). The asterisk indicates a wildcard for any number of characters and the question mark indicates a wildcard
for a single character. Uppercase or lowercase is not important. If the pattern string is not in the Host Portable Character
Encoding the result is implementation-dependent.
maxnames Specifies the maximum number of names that are to be in the returned list.
actual_count_return
Returns the actual number of font names in the list.
Returns
The list of font names.
Description
XListFonts() returns a list of font names that match the string pattern. Each returned font name string is terminated by NULL. If the
data returned by the server is in the Latin Portable Character Encoding, then the returned strings are in the Host Portable Character
Encoding. Otherwise, the result is implementation-dependent. The maximum number of names returned in the list is the value you passed to
maxnames. The function returns the actual number of font names in actual_count_return.
If no fonts match the specified names, XListFonts() returns NULL.
The client should call XFreeFontNames() when done with the font name list.
The font search path (the order in which font names in various directories are compared to pattern) is set by XSetFontPath().
For more information on fonts, see Volume One, Chapter 6, Drawing Graphics and Text.
See Also
XCreateFontCursor(), XFreeFont(), XFreeFontInfo(), XFreeFontNames(), XFreeFontPath(), XGetFontPath(), XGetFontProperty(), XListFontsWith-
Info(), XLoadFont(), XLoadQueryFont(), XQueryFont(), XSetFont(), XSetFontPath(), XUnloadFont().
Xlib - Fonts XListFonts()
