IDWriteFontSet4::GetMatchingFonts-Methode (dwrite_3.h)

Artikel
07/16/2024

Generiert einen übereinstimmenden Schriftsatz basierend auf den angeforderten Eingaben, sortiert, sodass näherer Ü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*

Schriftartfamilienname. Dies kann sein: typografischer Familienname, Gewicht/Stretch/Style Familienname, GDI (RBIZ)-Familienname 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 (d. h. algorithmische Veraltung und/oder Schrägung) auf übereinstimmende Schriftarten angewendet werden können, um die angegebenen Achsenwerte besser abzugleichen. 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_OKzurückgegeben. Andernfalls wird ein HRESULT-Fehlercodezurückgegeben.

Bemerkungen

Dies kann unterschiedliche Elemente liefern, die nicht im ursprünglichen Schriftartensatz enthalten waren, einschließlich Elementen mit Simulationskennzeichnungen (wenn sie einer näheren Übereinstimmung mit der Anforderung entsprechen) und Instanzen, die nicht vom Autor der Schriftart benannt wurden. Elemente aus den gleichen Schriftartressourcen werden in einer reduziert: die nächstmögliche Übereinstimmung.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 11 Build 22621
Header-	dwrite_3.h
Library	Dwrite.lib
DLL-	Dwrite.dll

Freigeben über