IDWriteFontFamily2::GetMatchingFonts-Methode (dwrite_3.h)

Ruft eine Liste der Schriftarten in der Schriftartfamilie ab, die sortiert wird, um zu ermitteln, wie gut sie den angegebenen Achsenwerten entsprechen.

Syntax

HRESULT GetMatchingFonts(
        DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
        UINT32                       fontAxisValueCount,
  [out] IDWriteFontList2             **matchingFonts
);

Parameter

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.

[out] matchingFonts

Typ: IDWriteFontList2**

Die Adresse eines Zeigers auf eine IDWriteFontList2 Schnittstelle. Nach erfolgreichem Abschluss legt die Funktion den Zeiger auf ein neu erstelltes Schriftartlistenobjekt fest.

Rückgabewert

Typ: HRESULT-

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

Anforderungen