CreateFontIndirectExW-Funktion (wingdi.h)
Die CreateFontIndirectEx--Funktion gibt eine logische Schriftart an, die die Merkmale in der angegebenen Struktur aufweist. Die Schriftart kann anschließend als aktuelle Schriftart für jeden Gerätekontext ausgewählt werden.
Syntax
HFONT CreateFontIndirectExW(
[in] const ENUMLOGFONTEXDVW *unnamedParam1
);
Parameter
[in] unnamedParam1
Zeiger auf eine ENUMLOGFONTEXDV Struktur, die die Merkmale einer mehrfachen Masterschriftart definiert.
Beachten Sie, dass diese Funktion den elfDesignVector Member in ENUMLOGFONTEXDV-ignoriert.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert der Handle für die neue ENUMLOGFONTEXDV Struktur.
Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Es sind keine erweiterten Fehlerinformationen verfügbar.
Bemerkungen
Die CreateFontIndirectEx--Funktion erstellt eine logische Schriftart mit den in der ENUMLOGFONTEXDV Struktur angegebenen Eigenschaften. Wenn diese Schriftart mithilfe der SelectObject--Funktion ausgewählt wird, versucht die Schriftartzuordnung von GDI mit der logischen Schriftart mit einer vorhandenen physischen Schriftart übereinzugleichen. Wenn eine genaue Übereinstimmung nicht gefunden werden kann, wird eine Alternative bereitgestellt, deren Merkmale so viele der angeforderten Merkmale wie möglich entsprechen.
Wenn Sie die Schriftart nicht mehr benötigen, rufen Sie die DeleteObject-Funktion auf, um sie zu löschen.
Die Schriftartzuordnung für CreateFont, CreateFontIndirectund CreateFontIndirectEx erkennt sowohl den englischen als auch den lokalisierten Schriftartnamen unabhängig vom Gebietsschema.
Anmerkung
Der wingdi.h-Header definiert CreateFontIndirectEx 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 |