CreateScalableFontResourceW-Funktion (wingdi.h)

Artikel
03/09/2024

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

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

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

Syntax

BOOL CreateScalableFontResourceW(
  [in] DWORD   fdwHidden,
  [in] LPCWSTR lpszFont,
  [in] LPCWSTR lpszFile,
  [in] LPCWSTR lpszPath
);

Parameter

[in] fdwHidden

Gibt an, ob es sich bei der Schriftart um eine schreibgeschützte Schriftart handelt. 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 Berechtigung und sollte vor anderen Anwendungen im System ausgeblendet werden. Wenn dieses Flag festgelegt ist, wird die Schriftart nicht von der Funktion EnumFonts oder EnumFontFamilies aufgelistet.

[in] lpszFont

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

[in] lpszFile

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

[in] lpszPath

Ein Zeiger auf eine NULL-Zeichenfolge, die den Pfad zur skalierbaren Schriftdatei 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 Schriftartenressourcendatei (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 einer .ttf Dateinamenerweiterung) muss sich im Unterverzeichnis System des Windows-Verzeichnisses befinden, um von der AddFontResource-Funktion verwendet zu werden.

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

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

Wenn im parameter lpszFontFile nur ein Dateiname und eine Erweiterung angegeben werden 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 lpszCurrentPath-Parameter 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 die .ttf datei beim Aufruf der Funktion AddFontResource an dem Speicherort befinden, der beim Aufruf der CreateScalableFontResource-Funktion im lpszFontFile-Parameter angegeben wurde. der lpszCurrentPath-Parameter wird nicht benötigt. Eine so 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 automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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

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 (einschließlich Windows.h)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll