Version vom 17. August 2008, 02:25 Uhr

XQueryFont

Name

XQueryFont - Liefert Informationen über eine Schriftart zurück.

Delphi-Spezifikation

function XQueryFont(dpy: PDisplay; font_ID: XID): PXFontStruct;

Parameter

Beschreibung

Die Funktion XQueryFont liefert einen Zeiger auf eine XFontStruct-Struktur zurück, welche die Informationen über die zugehörige Schriftart enthält. Man kann eine Schriftart selbst oder die in einem GC gespeicherte Schriftart abfragen. Die in der XFontStruct-Struktur gespeicherte ID wird die ID des GContexts sein, daher sollte man vorsichtig sein, wenn man diese ID in anderen Funktionen verwendet (siehe XGContextFromGC). Falls die angegebene Schriftart nicht existiert, gibt XQueryFont den Wert nil zurück. Um die erhaltenen Daten freinzugeben, kann XFreeFontInfo genutzt werden.

Hinweise

Die Struktur XFontStruct ist wie folgt definiert:

typedef struct {
     XExtData *ext_data; /* hook for extension to hang data */
     Font fid; /* Font id for this font */
     unsigned direction; /* hint about the direction 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;  /* maximum 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 decent below baseline for spacing */
} XFontStruct;

Die Struktur XCharStruct enthält folgende Elemente:

typedef struct {
     short lbearing;     /* origin to left edge of raster */
     short rbearing;     /* origin to right edge of raster */
     short width;   /* advance to next char's origin */
     short ascent;  /* baseline to top edge of raster */
     short descent; /* baseline to bottom edge of raster */
     unsigned short attributes;    /* per char flags (not predefined) */
} XCharStruct;

XFontProp ist wie folgt definiert:

typedef struct {
     Atom name;
     unsigned long card32;
} XFontProp;

Fehlermeldungen

Wenn die angebene Schriftart nicht gefunden werden konnte, wird nil zurückgegeben.

Siehe auch

XFreeFont, XListFonts, XLoadFont, XLoadQueryFont, XUnloadFont