CreateFontIndirectExA-Funktion (wingdi.h)

Artikel
08/27/2023

Die CreateFontIndirectEx-Funktion gibt eine logische Schriftart an, die die Merkmale in der angegebenen Struktur aufweist. Anschließend kann die Schriftart als aktuelle Schriftart für jeden Gerätekontext ausgewählt werden.

Syntax

HFONT CreateFontIndirectExA(
  [in] const ENUMLOGFONTEXDVA *unnamedParam1
);

Parameter

[in] unnamedParam1

Zeiger auf eine ENUMLOGFONTEXDV-Struktur, die die Merkmale einer schriftart mit mehreren master definiert.

Beachten Sie, dass diese Funktion den elfDesignVector-Member in ENUMLOGFONTEXDV ignoriert.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert das Handle für die neue ENUMLOGFONTEXDV-Struktur .

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Es sind keine erweiterten Fehlerinformationen verfügbar.

Hinweise

Die CreateFontIndirectEx-Funktion erstellt eine logische Schriftart mit den in der ENUMLOGFONTEXDV-Struktur angegebenen Merkmalen. Wenn diese Schriftart mithilfe der SelectObject-Funktion ausgewählt wird, versucht die Schriftartenzuordnung von GDI, die logische Schriftart einer vorhandenen physischen Schriftart zuzuordnen. Wenn keine genaue Übereinstimmung 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 Schriftartenzuordnung für CreateFont, CreateFontIndirect und CreateFontIndirectEx erkennt sowohl den englischen als auch den lokalisierten Schriftartnamen, unabhängig vom Gebietsschema.

Hinweis

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
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