XSetFontPath
Inhaltsverzeichnis
XSetFontPath
Name
XSetFontPath - Legt den Suchpfad für Schriftarten fest.
Delphi-Spezifikation
function XSetFontPath(dpy: PDisplay; directories: PPChar; ndirs: Integer): Integer;
Parameter
| dpy | Gibt die Verbindung zum X-Server an |
|---|---|
| directories | Array/ Liste von nullterminierten Zeichenketten, welche den Verzeichnispfad angibt, der bei der Suche nach Schriftarten benutzt wird. Falls man hier eine leere Liste angibt, wird der Standardwert für den X-Server wiederhergestellt. |
| ndirs | Gibt die Anzahl der Verzeichnisse im Pfad an |
Beschreibung
Die Funktion XSetFontPath legt den Verzeichnissuchpfad für Schriftartensuche fest. Es gibt nur einen Suchpfad pro X-Server, nicht einen pro Klient. Die Kodierung und Interpretation der Zeichenketten ist implementationsabhängig, aber typischerweise geben sie die Verzeichnisse oder Schriftartenserver an, welche in der aufgelisteten Reihenfolge durchsucht werden. Der X-Server kann Schriftarteninformationen intern zwischenspeichern; beispielsweise kann eine komplette Schriftart aus einer Datei zwischengespeichert werden, ohne dass bei nachfolgenden Operationen überprüft wird, ob sich die zugrundeliegende Datei verändert hat. Jedoch wird garantiert, dass der X-Server alle zwischengespeicherten Informationen über Schriftarten, für die gegenwärtig keine expliziten Ressourcen-IDs vorhanden sind, löscht, sobald der Schriftartenpfad geändert wird. Die Bedeutung eines durch diese Anfrage verursachten Fehlers ist implementationsabhängig.
Fehlermeldungen
XSetFontPath kann den Fehlerstatus BadValue generieren, allerdings ist die Bedeutung eines Fehlers bei dieser Funktion implementationsabhängig.
BadValue wird generiert, wenn ein numerischer Wert außerhalb des akzeptierten Wertebereichs liegt. Sofern kein bestimmter Bereich für ein Argument angegeben ist, wird der komplette Bereich, der durch den Typ des Arguments definiert ist, akzeptiert. Jedes Argument, das als eine Menge von Alternativen definiert ist, kann diesen Fehler generieren.
