AddFontResourceA-Funktion (wingdi.h)

Die AddFontResource-Funktion fügt die Schriftartressource aus der angegebenen Datei der Systemschriftarttabelle hinzu. Die Schriftart kann anschließend von jeder Anwendung für die Textausgabe verwendet werden.

Um eine Schriftart als privat oder nicht aufzählbar zu markieren, verwenden Sie die AddFontResourceEx-Funktion .

Syntax

int AddFontResourceA(
  [in] LPCSTR unnamedParam1
);

Parameter

[in] unnamedParam1

Ein Zeiger auf eine NULL-endende Zeichenfolge, die einen gültigen Schriftartdateinamen enthält. Dieser Parameter kann jede der folgenden Dateien angeben.

Dateierweiterung Bedeutung
.Fon
Ressourcendatei für Schriftarten.
.Fnt
Unformatierte Bitmapschriftdatei.
.ttf
Unformatierte TrueType-Datei.
.Ttc
Ostasiatische Fenster: TrueType-Schriftartensammlung.
.Fot
TrueType-Ressourcendatei.
.Otf
PostScript OpenType-Schriftart.
.Mmm
Mehrere master Type1-Schriftartressourcendatei. Sie muss mit PFM- und PFB-Dateien verwendet werden.
.Pfb
Geben Sie 1 Schriftbitsdatei ein. Sie wird mit einer PFM-Datei verwendet.
.Pfm
Geben Sie 1 Schriftartmetrikendatei ein. Sie wird mit einer PFB-Datei verwendet.
 

Wenn Sie eine Schriftart hinzufügen möchten, deren Informationen aus mehreren Ressourcendateien stammen, müssen Sie lpszFileName auf eine Zeichenfolge zeigen, wobei die Dateinamen durch ein "|" getrennt sind. Beispiel: abcxxxxx.pfm | abcxxxxx.pfb.

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

Jede Anwendung, die Schriftarten aus der Systemschriftarttabelle hinzufügt oder daraus entfernt, sollte andere Fenster über die Änderung benachrichtigen, indem sie eine WM_FONTCHANGE-Meldung an alle Fenster der obersten Ebene im Betriebssystem senden. Die Anwendung sollte diese Nachricht senden, indem sie die SendMessage-Funktion aufruft und den hwnd-Parameter auf HWND_BROADCAST festlegen.

Wenn eine Anwendung keine Schriftartressource mehr benötigt, die sie durch Aufrufen der AddFontResource-Funktion geladen hat, muss sie diese Ressource durch Aufrufen der RemoveFontResource-Funktion entfernen.

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 AddFontResource 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

   
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

AddFontResourceEx

Schriftart- und Textfunktionen

Übersicht über Schriftarten und Text

RemoveFontResource

SendMessage