CreateFontIndirectA-Funktion (wingdi.h)
Die CreateFontIndirect-Funktion erstellt eine logische Schriftart mit den angegebenen Merkmalen. Die Schriftart kann anschließend als aktuelle Schriftart für jeden Gerätekontext ausgewählt werden.
Syntax
HFONT CreateFontIndirectA(
[in] const LOGFONTA *lplf
);
Parameter
[in] lplf
Ein Zeiger auf eine LOGFONT- Struktur, die die Merkmale der logischen Schriftart definiert.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für eine logische Schriftart.
Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL-.
Bemerkungen
Die CreateFontIndirect-Funktion erstellt eine logische Schriftart mit den in der LOGFONT- Struktur angegebenen Merkmalen. 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.
Rufen Sie EnumFontFamiliesEx mit den gewünschten Schriftarteigenschaften in der LOGFONT--Struktur auf, rufen Sie den entsprechenden Schriftartnamen ab, rufen Sie den entsprechenden Schriftartnamen ab, und erstellen Sie die Schriftart mit CreateFont oder CreateFontIndirect.
Wenn Sie die Schriftart nicht mehr benötigen, rufen Sie die DeleteObject-Funktion auf, um sie zu löschen.
Die Schriftarten für viele ostasiatische Sprachen weisen zwei Schriftarten auf: einen englischen Namen und einen lokalisierten Namen. CreateFont und CreateFontIndirect den lokalisierten Schriftartnamen nur in einem Systemgebietsschema verwenden, das der Sprache entspricht, während sie den englischen Schriftartnamen für alle anderen Systemgebietsschemas übernehmen. Die beste Methode besteht darin, einen Namen zu versuchen, und versuchen Sie es bei einem Fehler mit dem anderen. Beachten Sie, dass EnumFonts, EnumFontFamiliesund EnumFontFamiliesEx den namen der englischen Schriftart zurückgeben, wenn das Gebietsschema nicht mit der Sprache der Schriftart übereinstimmt.
Die Schriftartzuordnung für CreateFont, CreateFontIndirectund CreateFontIndirectEx erkennt sowohl den englischen als auch den lokalisierten Schriftartnamen unabhängig vom Gebietsschema.
Beispiele
Ein Beispiel finden Sie unter Erstellen einer logischen Schriftart.
Anmerkung
Der wingdi.h-Header definiert CreateFontIndirect 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 |
Siehe auch
Schriftart- und Textfunktionen