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

Article
03/01/2024

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 (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 en 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’exécution réussie, la fonction définit le pointeur vers un objet de format texte nouvellement créé. Sinon, elle définit le pointeur sur nullptr.

Valeur retournée

Type : HRESULT

Si la fonction réussit, elle retourne S_OK. Sinon, il 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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10 Build 20348
Serveur minimal pris en charge	Windows 10 Build 20348
Plateforme cible	Windows
En-tête	dwrite_3.h
Bibliothèque	Dwrite.lib

Partager via