NAME

XGetFontProperty − get a font property given its atom. 

Synopsis

Bool XGetFontProperty(font_struct, atom, value_return)
XFontStruct *font_struct;
Atom atom;
unsigned long *value_return;

Arguments

font_struct
Specifies the storage associated with the font.

atomSpecifies the atom associated with the property name you want returned. 

value_return
Returns the value of the font property.

Description

XGetFontProperty() returns the value of the specified font property, given the atom for that property.  The function returns False if the atom was not defined, or True if was defined.  There are a set of predefined atoms for font properties which can be found in <X11/Xatom.h>.  These atoms are listed and described in Volume One, Chapter 6, Drawing Graphics and Text. This set contains the standard properties associated with a font.  The predefined font properties are likely but not guaranteed to be present for any given font.  See Volume One, Appendix I, Logical Font Description Conventions, for more information on font properties. 

Structures

typedef struct {
XExtData *ext_data;/* hook for extension to hang data */
Font fid;/* Font ID for this font */
unsigned direction;/* hint about direction the font is painted */
unsigned min_char_or_byte2;/* first character */
unsigned max_char_or_byte2;/* last character */
unsigned min_byte1;/* first row that exists */
unsigned max_byte1;/* last row that exists */
Bool all_chars_exist;/* flag if all characters have nonzero size*/
unsigned default_char;/* char to print for undefined character */
int n_properties;/* how many properties there are */
XFontProp *properties;/* pointer to array of additional properties*/
XCharStruct min_bounds;/* minimum bounds over all existing char*/
XCharStruct max_bounds;/* minimum bounds over all existing char*/
XCharStruct *per_char;/* first_char to last_char information */
int ascent;/* logical extent above baseline for spacing */
int descent;/* logical descent below baseline for spacing */
} XFontStruct;

See Also

XChangeProperty(), XDeleteProperty(), XGetWindowProperty(), XInternAtom(), XListProperties(), XRotateWindowProperties(), XSetStandardProperties(). 

Copyright O’Reilly & Assoc.  —