IDWriteFontSet1::GetMatchingFonts-Methode (dwrite_3.h)

Ruft einen übereinstimmenden Schriftsatz basierend auf den angeforderten Eingaben ab, sortiert, sodass näherer Übereinstimmungen früher sind.

Syntax

HRESULT GetMatchingFonts(
  DWRITE_FONT_PROPERTY const   *fontProperty,
  DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
  UINT32                       fontAxisValueCount,
  IDWriteFontSet1              **matchingFonts
);

Parameter

fontProperty

Typ: DWRITE_FONT_PROPERTY const *

Schriftarteigenschaft von Interesse, z. B. typografische Familie oder Gewicht/Stretch/Stilfamilie.

fontAxisValues

Typ: DWRITE_FONT_AXIS_VALUE const *

Ein Zeiger auf ein Array, das eine Liste von Schriftachsenwerten enthält. Das Array sollte die Größe (die Anzahl der Elemente) sein, die durch das argument fontAxisValueCount angegeben ist.

fontAxisValueCount

Typ: UINT32-

Die Anzahl der Schriftachsenwerte, die in der fontAxisValues Array enthalten sind.

matchingFonts

Typ: IDWriteFontSet1**

Die Adresse eines Zeigers auf eine IDWriteFontSet1 Schnittstelle. Nach erfolgreichem Abschluss legt die Funktion den Zeiger auf eine priorisierte Liste der Schriftarten fest, die den Eigenschaften entsprechen, andernfalls wird der Zeiger auf nullptrfestgelegt.

Rückgabewert

Typ: HRESULT-

Wenn die Funktion erfolgreich ist, wird S_OKzurückgegeben. Andernfalls wird ein HRESULT-Fehlercodezurückgegeben.

Bemerkungen

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