IDWriteFontResource::CreateFontFaceReference-Methode (dwrite_3.h)

Erstellt einen Schriftzeichenbezug mit bestimmten Achsenwerten.

Syntax

HRESULT CreateFontFaceReference(
        DWRITE_FONT_SIMULATIONS      fontSimulations,
        DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
        UINT32                       fontAxisValueCount,
  [out] IDWriteFontFaceReference1    **fontFaceReference
);

Parameter

fontSimulations

Typ: DWRITE_FONT_SIMULATIONS

Font face simulation flags for algorithmic emboldening and italicization.

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] fontFaceReference

Typ: IDWriteFontFaceReference1**

Die Adresse eines Zeigers auf eine IDWriteFontFaceReference1 Schnittstelle. Nach erfolgreichem Abschluss legt die Funktion den Zeiger auf ein neu erstelltes Schriftart-Gesichtsbezugsobjekt fest, 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

Die von Ihnen bereitgestellten Achsenwerte dürfen eine Teilmenge oder Eine Obermenge aller elemente sein, die tatsächlich von der Schriftart unterstützt werden. Alle nicht angegebenen Achsen verwenden ihre Standardwerte: Werte, die über die Bereiche hinausgehen, werden geklemmt, und alle nicht variierenden Achsen haben keine Auswirkung.

Anforderungen