IDWriteFactory6 ::CreateTextFormat, méthode (dwrite_3.h)

Crée un objet de format de texte utilisé pour la disposition du texte.

Syntaxe

HRESULT CreateTextFormat(
  WCHAR const                  *fontFamilyName,
  IDWriteFontCollection        *fontCollection,
  DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
  UINT32                       fontAxisValueCount,
  FLOAT                        fontSize,
  WCHAR const                  *localeName,
  IDWriteTextFormat3           **textFormat
);

Paramètres

fontFamilyName

Type : WCHAR const *

Nom de la famille de polices de la collection.

fontCollection

Type : IDWriteFontCollection*

Collection de polices. Utilisez nullptr pour indiquer la collection de polices système.

fontAxisValues

Type : DWRITE_FONT_AXIS_VALUE const *

Pointeur vers un tableau contenant une liste de valeurs d’axe de police. Le tableau doit être la taille (le nombre d’éléments) indiquée par l’argument fontAxisValueCount.

fontAxisValueCount

Type : UINT32

Nombre de valeurs d’axe de police contenues dans le tableau fontAxisValues.

fontSize

Type : FLOAT

Taille logique de la police dans les unités DIP.

localeName

Type : WCHAR const *

Nom des paramètres régionaux (par exemple, «ja-JP», «en-US», «ar-EG»).

textFormat

Type : IDWriteTextFormat3**

Adresse d’un pointeur vers une interface IDWriteTextFormat3. Une fois l’achèvement réussi, la fonction définit le pointeur sur un objet de format de texte nouvellement créé ; sinon, il définit le pointeur sur nullptr.

Valeur de retour

Type : HRESULT

Si la fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Si fontCollection est nullptr, la collection de polices système est utilisée, regroupée par nom de famille typographique (DWRITE_FONT_FAMILY_MODEL_TYPOGRAPHIC) sans polices téléchargeables.

Exigences