AddFontResourceExA-Funktion (wingdi.h)
Die AddFontResourceEx-Funktion fügt die Schriftartressource aus der angegebenen Datei dem System hinzu. Schriftarten, die mit der AddFontResourceEx-Funktion hinzugefügt werden, können als privat und nicht aufzählbar markiert werden.
Syntax
int AddFontResourceExA(
[in] LPCSTR name,
[in] DWORD fl,
[in] PVOID res
);
Parameter
[in] name
Ein Zeiger auf eine NULL-endende Zeichenfolge, die einen gültigen Schriftartdateinamen enthält. Dieser Parameter kann jede der folgenden Dateien angeben.
Um eine Schriftart hinzuzufügen, deren Informationen aus mehreren Ressourcendateien stammen, verweisen Sie lpszFileName auf eine Zeichenfolge, deren Dateinamen durch | --z. B. abcxxxxx.pfm | abcxxxxx.pfb.
[in] fl
Die Merkmale der Schriftart, die dem System hinzugefügt werden soll. Dieser Parameter kann einen der folgenden Werte annehmen.
[in] res
Reserviert. Muss Null sein.
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt der Rückgabewert die Anzahl der hinzugefügten Schriftarten an.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Es sind keine erweiterten Fehlerinformationen verfügbar.
Hinweise
Diese Funktion ermöglicht es einem Prozess, Schriftarten zu verwenden, ohne anderen Prozessen zugriff auf die Schriftarten zu gewähren.
Wenn eine Anwendung keine Schriftartressource mehr benötigt, die sie durch Aufrufen der AddFontResourceEx-Funktion geladen hat, muss sie die Ressource entfernen, indem sie die RemoveFontResourceEx-Funktion aufruft .
Diese Funktion installiert die Schriftart nur für die aktuelle Sitzung. Wenn das System neu gestartet wird, ist die Schriftart nicht vorhanden. Damit die Schriftart auch nach dem Neustart des Systems installiert werden kann, muss die Schriftart in der Registrierung aufgeführt werden.
Eine Schriftart, die in der Registrierung aufgeführt und an einem anderen Speicherort als dem Ordner %windir%\fonts\ installiert ist, kann nicht geändert, gelöscht oder ersetzt werden, solange sie in einer Sitzung geladen wird. Um eine dieser Schriftarten zu ändern, muss sie zuerst durch Aufrufen von RemoveFontResource entfernt, aus der Schriftartenregistrierung entfernt werden (HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fonts), und das System neu gestartet werden. Nach dem Neustart des Systems wird die Schriftart nicht mehr geladen und kann geändert werden.
Hinweis
Der wingdi.h-Header definiert AddFontResourceEx als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wingdi.h (windows.h einschließen) |
| Bibliothek | Gdi32.lib |
| DLL | Gdi32.dll |
Weitere Informationen
Schriftart- und Textfunktionen