IDWriteFontSet4::GetMatchingFonts-Methode (dwrite_3.h)

Artikel
08/23/2023

Generiert einen übereinstimmenden Schriftartensatz basierend auf den angeforderten Eingaben, geordnet, sodass die näheren Übereinstimmungen früher sind.

Syntax

HRESULT GetMatchingFonts(
  WCHAR const                  *familyName,
  DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
  UINT32                       fontAxisValueCount,
  DWRITE_FONT_SIMULATIONS      allowedSimulations,
  IDWriteFontSet4              **matchingFonts
);

Parameter

familyName

Typ: _In_z_ WCHAR const*

Name der Schriftfamilie. Dies kann sein: typografischer Familienname, Gewicht/Stretch-/Stilfamilienname, GDI-Familienname (RBIZ) oder vollständiger Name.

fontAxisValues

Typ: _In_reads_(fontAxisValueCount) DWRITE_FONT_AXIS_VALUE const*

Array von Schriftachsenwerten.

fontAxisValueCount

Typ: UINT32

Anzahl der Schriftachsenwerte.

allowedSimulations

Typ: DWRITE_FONT_SIMULATIONS

Gibt an, welche Simulationen (also algorithmische Verschönerung und/oder Schrägstriche) auf übereinstimmende Schriftarten angewendet werden können, um besser mit den angegebenen Achsenwerten übereinzupassen. Wenn das Argument DWRITE_FONT_SIMULATIONS_NONE (0) ist, werden keine Simulationen angewendet.

matchingFonts

Typ: _COM_Outptr_ IDWriteFontSet4**

Empfängt einen Zeiger auf einen neu erstellten Schriftartensatz, der eine priorisierte Liste von Schriftarten enthält, die den angegebenen Eingaben entsprechen.

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Hinweise

Dies kann zu unterschiedlichen Elementen führen, die sich nicht im ursprünglichen Schriftartensatz befanden, einschließlich Elementen mit Simulationsflags (wenn sie der Anforderung näher entsprechen würden) und Instanzen, die nicht vom Schriftartautor benannt wurden. Elemente aus den gleichen Schriftartressourcen werden in eine reduziert: die am nächsten mögliche Übereinstimmung.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 11 Build 22621
Kopfzeile	dwrite_3.h
Bibliothek	Dwrite.lib
DLL	Dwrite.dll

Freigeben über