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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour