AddFontResourceExA-Funktion (wingdi.h)

Die funktion AddFontResourceEx fügt die Schriftartressource aus der angegebenen Datei dem System hinzu. Schriftarten, die mit der funktion AddFontResourceEx hinzugefügt werden, können als privat und nicht aufgezählt werden.

Syntax

int AddFontResourceExA(
  [in] LPCSTR name,
  [in] DWORD  fl,
  [in] PVOID  res
);

Parameter

[in] name

Ein Zeiger auf eine mit Null beendete Zeichenfolge, die einen gültigen Dateinamen für schriftarten enthält. Dieser Parameter kann eine der folgenden Dateien angeben.

Dateiendung	Bedeutung
.fon	Schriftartressourcendatei.
.fnt	Unformatierte Bitmapschriftartdatei.
.ttf	Raw TrueType-Datei.
.ttc-	Ostasiatische Windows: TrueType-Schriftartsammlung.
FOT-	TrueType-Ressourcendatei.
.otf	PostScript OpenType-Schriftart.
MMM-	Ressourcendatei für mehrere Master-Type1-Schriftarten. Sie muss mit PFM- und PFB-Dateien verwendet werden.
PFB-	Geben Sie 1 Schriftartbitsdatei ein. Sie wird mit einer PFM-Datei verwendet.
PFM-	Geben Sie 1 Schriftartmetrikendatei ein. Sie wird mit einer PFB-Datei verwendet.

 

Um eine Schriftart hinzuzufügen, deren Informationen aus mehreren Ressourcendateien stammen, zeigen Sie lpszFileName auf eine Zeichenfolge mit den Dateinamen, die durch ein | getrennt sind --z. B. abcxxxxx.pfm | abcxxxxx.pfb.

[in] fl

Die Merkmale der Schriftart, die dem System hinzugefügt werden soll. Dieser Parameter kann einer der folgenden Werte sein:

Wert	Bedeutung
FR_PRIVATE	Gibt an, dass nur der Prozess, der die AddFontResourceEx--Funktion aufgerufen hat, diese Schriftart verwenden kann. Wenn der Schriftartname einer öffentlichen Schriftart entspricht, wird die private Schriftart ausgewählt. Wenn der Prozess beendet wird, entfernt das System alle vom Prozess installierten Schriftarten mit der funktion AddFontResourceEx.
FR_NOT_ENUM	Gibt an, dass kein Prozess, einschließlich des Prozesses, der die funktion AddFontResourceEx aufgerufen hat, diese Schriftart aufzählen kann.

[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 fehlschlägt, ist der Rückgabewert null. Es sind keine erweiterten Fehlerinformationen verfügbar.

Bemerkungen

Diese Funktion ermöglicht es einem Prozess, Schriftarten zu verwenden, ohne anderen Prozessen den Zugriff auf die Schriftarten zu ermöglichen.

Wenn eine Anwendung keine Schriftartressource mehr benötigt, die sie geladen hat, indem sie die AddFontResourceEx--Funktion aufruft, muss sie die Ressource entfernen, indem sie die funktion RemoveFontResourceEx 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 wird, muss die Schriftart in der Registrierung aufgeführt werden.

Eine in der Registrierung aufgeführte Schriftart, die an einem anderen Speicherort als dem Ordner %windir%\fonts\ installiert ist, kann nicht geändert, gelöscht oder ersetzt werden, solange sie in einer beliebigen Sitzung geladen wird. Um eine dieser Schriftarten zu ändern, muss sie zuerst entfernt werden, indem RemoveFontResourceaufgerufen wird, aus der Schriftartregistrierung (HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fonts) entfernt und das System neu gestartet wurde. Nach dem Neustart des Systems wird die Schriftart nicht mehr geladen und kann geändert werden.

Anmerkung

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
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	wingdi.h (enthalten Windows.h)
Library	Gdi32.lib
DLL-	Gdi32.dll

Siehe auch

Schriftart- und Textfunktionen

Schriftarten und Textübersicht

RemoveFontResourceEx-

SendMessage-