Partager via


ID2D1RenderTarget ::D rawTextLayout, méthode (d2d1.h)

Dessine le texte mis en forme décrit par l’objet IDWriteTextLayout spécifié.

Syntaxe

void DrawTextLayout(
       D2D1_POINT_2F          origin,
  [in] IDWriteTextLayout      *textLayout,
  [in] ID2D1Brush             *defaultFillBrush,
       D2D1_DRAW_TEXT_OPTIONS options
);

Paramètres

origin

Type : D2D1_POINT_2F

Point, décrit dans pixels indépendants de l’appareil, à partir duquel le coin supérieur gauche du texte décrit par textLayout est dessiné.

[in] textLayout

Type : IDWriteTextLayout*

Texte mis en forme à dessiner. Tous les effets de dessin qui n’héritent pas d’ID2D1Resource sont ignorés. S’il existe des effets de dessin qui héritent d’ID2D1Resource qui ne sont pas des pinceaux, cette méthode échoue et la cible de rendu est placée dans un état d’erreur.

[in] defaultFillBrush

Type : ID2D1Brush*

Pinceau utilisé pour peindre tout texte dans textLayout qui n’a pas encore de pinceau associé en tant qu’effet de dessin (spécifié par la méthode IDWriteTextLayout ::SetDrawingEffect ).

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.

Valeur de retour

None

Remarques

Lorsque vous dessinez le même texte à plusieurs reprises, l’utilisation de la méthode DrawTextLayout est plus efficace que l’utilisation de la méthode DrawText , car le texte n’a pas besoin d’être mis en forme et la disposition traitée à chaque appel.

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 DrawTextLayout) a échoué, case activée le résultat retourné par les méthodes ID2D1RenderTarget ::EndDraw ou ID2D1RenderTarget ::Flush.

Configuration requise

Condition requise Valeur
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

ID2D1RenderTarget

Mise en forme et disposition du texte