PEXListFonts - List PEX Fonts (5.0)


Synopsis

 
   char **PEXListFonts(
        Display *display,
        char *pattern,
        unsigned int max_names,
        unsigned long *count_return
   )
 

Arguments

display
A pointer to a display structure returned by a successful XOpenDisplay call.

pattern
A null-terminated string pattern.

max_names
The maximum number of names to be returned.

count_return
Returns the actual number of font names.

Returns

An array of font names (null-terminated strings); a null pointer if unsuccessful or if no PEX fonts supported.

Description

Invoke PEXListFonts which is similar to X11 XListFonts except that this function only returns information about fonts that can be used by PEX.

The returned list may or may not contain some of the same fonts returned by the X11 XListFonts function.

This function returns a list of entries, each of which contains the name of a font matching the pattern. The pattern is a string that uses the ISO Latin-1 encoding. Case is not significant in matching names. The '?' character (octal value 077) matches any single character, and the character '*' (octal value 052) matches any number of characters. The returned names are null-terminated, in lower-case and are also ISO Latin-1 encoded strings.

PEXlib allocates memory for the returned list of font names. Invoke PEXFreeFontNames to deallocate the memory.

Errors

None.

See Also

For a list of PEX Font functions and related topics, see PEX Fonts.