ID2D1RenderTarget ::D rawText(constWCHAR*,UINT32,IDWriteTextFormat*,constD2D1_RECT_F&,ID2D1Brush*,D2D1_DRAW_TEXT_OPTIONS,DWRITE_MEASURING_MODE) (d2d1.h)

Dessine le texte spécifié à l’aide des informations de format fournies par un objet IDWriteTextFormat .

Syntaxe

void DrawText(
  [in]  const WCHAR            *string,
        UINT32                 stringLength,
  [in]  IDWriteTextFormat      *textFormat,
  [ref] const D2D1_RECT_F &    layoutRect,
  [in]  ID2D1Brush             *defaultFillBrush,
        D2D1_DRAW_TEXT_OPTIONS options,
        DWRITE_MEASURING_MODE  measuringMode
);

Paramètres

[in] string

Type : WCHAR*

Pointeur vers un tableau de caractères Unicode à dessiner.

stringLength

Type : UINT

Nombre de caractères dans la chaîne.

[in] textFormat

Type : IDWriteTextFormat*

Objet qui décrit la mise en forme des détails du texte à dessiner, tels que la police, la taille de la police et le sens du flux.

[ref] layoutRect

Type : const D2D1_RECT_F

Taille et position de la zone dans laquelle le texte est dessiné.

[in] defaultFillBrush

Type : ID2D1Brush*

Pinceau utilisé pour peindre le texte.

options

Type : D2D1_DRAW_TEXT_OPTIONS

Valeur qui indique si le texte doit être aligné sur des limites de pixels et si le texte doit être coupé dans le rectangle de disposition. La valeur par défaut est D2D1_DRAW_TEXT_OPTIONS_NONE, ce qui indique que le texte doit être aligné sur les limites des pixels et qu’il ne doit pas être rogné sur le rectangle de disposition.

measuringMode

Type : DWRITE_MEASURING_MODE

Valeur qui indique comment les métriques de glyphe sont utilisées pour mesurer le texte lorsqu’il est mis en forme. La valeur par défaut est DWRITE_MEASURING_MODE_NATURAL.

Valeur de retour

None

Remarques

Pour créer un objet IDWriteTextFormat , créez un IDWriteFactory et appelez sa méthode CreateTextFormat .

Cette méthode ne retourne pas de code d’erreur en cas d’échec. Pour déterminer si une opération de dessin (telle que DrawText) a échoué, case activée le résultat retourné par les méthodes ID2D1RenderTarget ::EndDraw ou ID2D1RenderTarget ::Flush.

Exemples

Pour obtenir un exemple, consultez Guide pratique pour dessiner du texte.

Configuration requise

Client minimal pris en charge	Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista [applications de bureau | Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 R2, Windows Server 2008 avec SP2 et Mise à jour de plateforme pour Windows Server 2008 [applications de bureau | Applications UWP]
Plateforme cible	Windows
En-tête	d2d1.h
Bibliothèque	D2d1.lib
DLL	D2d1.dll

Voir aussi

DWRITE_MEASURING_MODE

DrawTextLayout

Guide pratique pour dessiner du texte

ID2D1RenderTarget

Mise en forme et disposition du texte