IDWriteFontResource::GetDefaultFontAxisValues-Methode (dwrite_3.h)

Artikel
11/20/2024

Ruft die Standardwerte für alle Achsen ab, die von der Schriftartressource unterstützt werden.

Syntax

HRESULT GetDefaultFontAxisValues(
  [out] DWRITE_FONT_AXIS_VALUE *fontAxisValues,
        UINT32                 fontAxisValueCount
);

Parameter

[out] fontAxisValues

Typ: DWRITE_FONT_AXIS_VALUE*

Ein Zeiger auf ein Array DWRITE_FONT_AXIS_VALUE Strukturen, in das GetDefaultFontAxisValues die Liste der Schriftachsenwerte schreibt. Sie sind für die Verwaltung der Größe und der Lebensdauer dieses Arrays verantwortlich. Rufen Sie GetFontAxisCount auf, um die Größe des arrays zu bestimmen, das zugeordnet werden soll.

fontAxisValueCount

Typ: UINT32-

Die maximale Anzahl von Schriftachsenwerten, auf die in den Speicherblock geschrieben werden soll, auf den fontAxisValuesverweist.

Rückgabewert

Typ: HRESULT-

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

Rückgabewert	Beschreibung
E_INVALIDARG	`fontAxisValueCount` stimmt nicht mit dem von GetFontAxisCountzurückgegebenen Wert überein.

Bemerkungen

Möglicherweise weisen unterschiedliche Schriftartressourcen unterschiedliche Standardwerte auf. Bei OpenType 1.8-Schriftarten stammen diese Werte aus den Tabellen STAT und fvar. Bei älteren Schriftarten ohne STAT-Tabelle wird die Os/2-Tabelle mit breite-breite-kursiv gelesen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 10 Build 16299
mindestens unterstützte Server-	Windows 10 Build 16299
Zielplattform-	Fenster
Header-	dwrite_3.h
Library	Dwrite.lib

Freigeben über