CreateScalableFontResourceW-Funktion (wingdi.h)
[Die CreateScalableFontResource-Funktion steht für die Verwendung in den im Abschnitt "Anforderungen" angegebenen Betriebssystemen zur Verfügung. Es kann sein
in nachfolgenden Versionen geändert oder nicht verfügbar.]
Die CreateScalableFontResource-Funktion erstellt eine Schriftartressourcendatei 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 die Schriftart eine schreibgeschützte Schriftart ist. Dieser Parameter kann einer der folgenden Werte sein:
| Wert | Bedeutung |
|---|---|
|
Die Schriftart verfügt über Lese-/Schreibberechtigungen. |
|
Die Schriftart verfügt über schreibgeschützte Berechtigung und sollte von anderen Anwendungen im System ausgeblendet werden. Wenn dieses Kennzeichen festgelegt ist, wird die Schriftart nicht durch die EnumFonts- oder EnumFontFamilies-funktion aufgezählt. |
[in] lpszFont
Ein Zeiger auf eine mit Null beendete 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 mit Null beendete Zeichenfolge, die den Namen der skalierbaren Schriftartdatei angibt, die von dieser Funktion zum Erstellen der Schriftartressourcendatei verwendet wird.
[in] lpszPath
Ein Zeiger auf eine mit Null beendete Zeichenfolge, die den Pfad zur skalierbaren Schriftartdatei angibt.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlschlägt, ist der Rückgabewert null.
Wenn lpszFontRes eine vorhandene Schriftartdatei angibt, gibt GetLastError- ERROR_FILE_EXISTS
Bemerkungen
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 verwendet dann die AddFontResource-Funktion, um die Schriftart zu installieren. Die TrueType-Schriftartdatei (in der Regel mit einer .ttf Dateinamenerweiterung) muss sich im Systemunterverzeichnis des Windows-Verzeichnisses befinden, das von der AddFontResource-funktion verwendet werden soll.
Die CreateScalableFontResource-Funktion unterstützt derzeit nur skalierbare TrueType-Technologie-Schriftarten.
Wenn der parameter lpszFontFile nur einen Dateinamen und eine Erweiterung angibt, muss der parameter lpszCurrentPath einen Pfad angeben. Wenn der parameter lpszFontFile einen vollständigen Pfad angibt, muss der lpszCurrentPath Parameter NULL- oder ein Zeiger auf NULL-sein.
Wenn nur ein Dateiname und eine Erweiterung im parameter lpszFontFile angegeben werden und ein Pfad im lpszCurrentPath Parameter 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 kopiert wurde (oder im Fall einer Netzwerkinstallation in das Windows-Hauptverzeichnis). 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 parameter lpszFontFile angegeben wird und NULL- im parameter lpszCurrentPath angegeben wird, wird die Zeichenfolge in lpszFontFile in die FOT-Datei kopiert. Wenn die AddFontResource--Funktion aufgerufen wird, muss sich die .ttf Datei an dem Speicherort befinden, der im lpszFontFile Parameter angegeben ist, wenn die CreateScalableFontResource Funktion aufgerufen wurde; der parameter lpszCurrentPath ist nicht erforderlich. 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.
Anmerkung
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
| 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 |