AddFontResourceExW-Funktion (wingdi.h)

Artikel
08/27/2023

Die AddFontResourceEx-Funktion fügt die Schriftartressource aus der angegebenen Datei dem System hinzu. Mit der Funktion AddFontResourceEx hinzugefügte Schriftarten können als privat und nicht aufzählbar markiert werden.

Syntax

int AddFontResourceExW(
  [in] LPCWSTR name,
  [in] DWORD   fl,
  [in] PVOID   res
);

Parameter

[in] name

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

Dateierweiterung	Bedeutung
.Fon	Schriftartressourcendatei.
.Fnt	Unformatierte Bitmapschriftdatei.
.ttf	Unformatierte TrueType-Datei.
.Ttc	Ostasiatische Fenster: TrueType-Schriftsammlung.
.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 Schriftbitdatei 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 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.

Wert	Bedeutung
FR_PRIVATE	Gibt an, dass nur der Prozess, der die AddFontResourceEx-Funktion aufgerufen hat, diese Schriftart verwenden kann. Wenn der Schriftartname mit einer öffentlichen Schriftart übereinstimmt, wird die private Schriftart ausgewählt. Wenn der Prozess beendet wird, entfernt das System alle Schriftarten, die vom Prozess mit der AddFontResourceEx-Funktion installiert wurden.
FR_NOT_ENUM	Gibt an, dass kein Prozess, einschließlich des Prozesses, der die AddFontResourceEx-Funktion aufgerufen hat, diese Schriftart auflisten 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 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 den Zugriff auf die Schriftarten zu gewähren.

Wenn eine Anwendung keine Schriftartressource mehr benötigt, die sie durch Aufrufen der Funktion AddFontResourceEx 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 wird, 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 entfernt werden, indem RemoveFontResource aufgerufen, aus der Schriftartenregistrierung entfernt wird (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 nicht codierungsneutralem Code 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 (einschließlich Windows.h)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll

Weitere Informationen

Schriftart- und Textfunktionen

Übersicht über Schriftarten und Text

RemoveFontResourceEx

SendMessage

Share via