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 |