IDWriteFontSet1::GetMatchingFonts-Methode (dwrite_3.h)

Artikel
08/23/2023

Ruft einen übereinstimmenden Schriftartensatz basierend auf den angeforderten Eingaben ab, geordnet, sodass die näheren Ü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 *

Schrifteigenschaft 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) aufweisen, die durch das argument fontAxisValueCount angegeben wird.

fontAxisValueCount

Typ: UINT32

Die Anzahl der Im FontAxisValues-Array enthaltenen Schriftachsenwerte.

matchingFonts

Typ: IDWriteFontSet1**

Die Adresse eines Zeigers auf eine IDWriteFontSet1-Schnittstelle . Bei erfolgreicher Fertigstellung legt die Funktion den Zeiger auf eine priorisierte Liste von Schriftarten fest, die den Eigenschaften entsprechen. Andernfalls wird der Zeiger auf nullptrfestgelegt.

Rückgabewert

Typ: HRESULT

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

Hinweise

Diese Methode kann unterschiedliche Elemente liefern, die sich nicht im ursprünglichen Schriftartensatz befanden, einschließlich Elementen mit Simulationsflags (wenn sie näher mit der Anforderung übereinstimmen würden) und Instanzen, die nicht vom Autor der Schriftart benannt wurden. Elemente aus den gleichen Schriftartressourcen werden in eine reduziert: die am nächsten mögliche Übereinstimmung.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 10 Build 20348
Unterstützte Mindestversion (Server)	Windows 10 Build 20348
Zielplattform	Windows
Kopfzeile	dwrite_3.h
Bibliothek	Dwrite.lib

Freigeben über