CreateScalableFontResourceA-Funktion (wingdi.h)

[Die CreateScalableFontResource-Funktion ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Es kann sein, dass

geändert oder in nachfolgenden Versionen nicht verfügbar.]

Die CreateScalableFontResource-Funktion erstellt eine Schriftartressourcendatei für eine skalierbare Schriftart.

Syntax

BOOL CreateScalableFontResourceA(
  [in] DWORD  fdwHidden,
  [in] LPCSTR lpszFont,
  [in] LPCSTR lpszFile,
  [in] LPCSTR lpszPath
);

Parameter

[in] fdwHidden

Gibt an, ob die Schriftart eine schreibgeschützte Schriftart ist. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
0	Die Schriftart verfügt über Lese-/Schreibberechtigungen.
1	Die Schriftart verfügt über schreibgeschützte Berechtigungen und sollte für andere Anwendungen im System ausgeblendet werden. Wenn dieses Flag festgelegt ist, wird die Schriftart nicht durch die Funktion EnumFonts oder EnumFontFamilies aufgezählt.

[in] lpszFont

Ein Zeiger auf eine NULL-endende Zeichenfolge, die den Namen der zu erstellenden Schriftartressourcendatei angibt. Wenn dieser Parameter eine vorhandene Schriftartressourcendatei angibt, schlägt die Funktion fehl.

[in] lpszFile

Ein Zeiger auf eine NULL-endende Zeichenfolge, die den Namen der skalierbaren Schriftartdatei angibt, die diese Funktion zum Erstellen der Schriftartressourcendatei verwendet.

[in] lpszPath

Ein Zeiger auf eine NULL-endende Zeichenfolge, die den Pfad zur skalierbaren Schriftartdatei angibt.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null.

Wenn lpszFontRes eine vorhandene Schriftartdatei angibt, gibt GetLastError ERROR_FILE_EXISTS

Hinweise

Die CreateScalableFontResource-Funktion wird von Anwendungen verwendet, die TrueType-Schriftarten installieren. Eine Anwendung verwendet die CreateScalableFontResource-Funktion , um eine Schriftartressourcendatei (in der Regel mit der Dateinamenerweiterung .fot) zu erstellen und dann die AddFontResource-Funktion zum Installieren der Schriftart zu verwenden. Die TrueType-Schriftartdatei (in der Regel mit der Dateinamenerweiterung .ttf) muss sich im Unterverzeichnis System des Windows-Verzeichnisses befinden, das von der AddFontResource-Funktion verwendet werden soll.

Die CreateScalableFontResource-Funktion unterstützt derzeit nur skalierbare TrueType-Schriftarten.

Wenn der parameter lpszFontFile nur einen Dateinamen und eine Erweiterung angibt, muss der parameter lpszCurrentPath einen Pfad angeben. Wenn der lpszFontFile-Parameter einen vollständigen Pfad angibt, muss der lpszCurrentPath-ParameterNULL oder ein Zeiger auf NULL sein.

Wenn im lpszFontFile-Parameter nur ein Dateiname und eine Erweiterung angegeben sind und im lpszCurrentPath-Parameter ein Pfad angegeben wird, wird die Zeichenfolge in lpszFontFile als TTF-Datei, die zu dieser Ressource gehört, in die FOT-Datei kopiert. Wenn die AddFontResource-Funktion aufgerufen wird, geht das Betriebssystem davon aus, dass die TTF-Datei in das Systemverzeichnis (oder im Fall einer Netzwerkinstallation in das Standard Windows-Verzeichnis) kopiert wurde. Die TTF-Datei muss sich nicht in diesem Verzeichnis befinden, wenn die CreateScalableFontResource-Funktion aufgerufen wird, da der parameter lpszCurrentPath die Verzeichnisinformationen enthält. Eine auf diese Weise erstellte Ressource enthält keine absoluten Pfadinformationen und kann in jeder Installation verwendet werden.

Wenn ein Pfad im lpszFontFile-Parameter und NULL im lpszCurrentPath-Parameter angegeben wird, wird die Zeichenfolge in lpszFontFile in die FOT-Datei kopiert. In diesem Fall muss sich beim Aufruf der AddFontResource-Funktion die TTF-Datei an dem Speicherort befinden, der im lpszFontFile-Parameter angegeben ist, als die CreateScalableFontResource-Funktion aufgerufen wurde. der Parameter lpszCurrentPath wird nicht benötigt. Eine auf diese Weise erstellte Ressource enthält absolute Verweise auf Pfade und Laufwerke und funktioniert nicht, wenn die TTF-Datei an einen anderen Speicherort verschoben wird.

Hinweis

Der wingdi.h-Header definiert CreateScalableFontResource 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

AddFontResource

EnumFontFamilies

EnumFonts

Schriftart- und Textfunktionen

Übersicht über Schriftarten und Text