DrawTextWrap fonction)
[DrawTextWrap est disponible via Windows XP avec Service Pack 2 (SP2). Il peut être modifié ou non disponible dans les versions ultérieures. Il est recommandé d’utiliser DrawText directement à la place.]
Dessine du texte mis en forme dans le rectangle spécifié. Il met en forme le texte en fonction de la méthode spécifiée (en développant les onglets, en justifiant les caractères, les sauts de ligne, etc.). Cette fonction encapsule un appel à DrawText.
Syntaxe
int WINAPI DrawTextWrap(
_In_ HDC hdc,
_Inout_ LPCTSTR lpString,
_In_ int nCount,
_Inout_ LPRECT lpRect,
_In_ UINT uFormat,
_In_ LPDRAWTEXTPARAMS lpDTParams
);
Paramètres
-
HDC [ dans]
-
Type : HDC
Handle vers le contexte de périphérique (Device Context).
-
lpString [ in, out]
-
Type : LPCTSTR
Pointeur vers une mémoire tampon qui contient le texte à dessiner. Si le paramètre nCount a la valeur-1, la chaîne doit se terminer par un caractère null.
Si uFormat comprend DT _ MODIFYSTRING, la fonction peut ajouter jusqu’à quatre caractères supplémentaires à cette chaîne. La mémoire tampon qui contient la chaîne doit être suffisamment grande pour prendre en charge ces caractères supplémentaires.
-
nCount [ dans]
-
Type : int
Longueur de la chaîne vers laquelle pointe lpString. Si nCount a la valeur-1, le paramètre lpString est supposé être un pointeur vers une chaîne terminée par le caractère null et DrawText calcule automatiquement le nombre de caractères.
-
lpRect [ in, out]
-
Type : LPRECT
Pointeur vers une structure Rect qui contient le rectangle, en coordonnées logiques, dans lequel le texte doit être mis en forme.
-
uFormat [ dans]
-
Type : uint
Options de mise en forme. Pour obtenir la liste complète des options, consultez la documentation de DrawText .
-
lpDTParams [ dans]
-
Type : LPDRAWTEXTPARAMS
Pointeur vers une structure DRAWTEXTPARAMS qui spécifie des options de mise en forme supplémentaires. Ce paramètre peut être NULL.
Valeur de retour
Type : int
Si la fonction est réussie, la valeur de retour est la hauteur du texte en unités logiques. Si DT _ VCENTER ou DT _ Bottom est spécifié, la valeur de retour est le décalage par rapport au membre supérieur de LPRC au bas du texte dessiné si la fonction échoue, la valeur de retour est zéro.
Si la fonction échoue, la valeur de retour est égale à zéro.
Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
DrawTextWrap n’est pas exporté par nom ou déclaré dans un en-tête public. Pour l’utiliser, vous devez utiliser GetProcAddress et demander l’ordinal 415 de ComCtl32.dll pour obtenir un pointeur de fonction.
Pour des remarques supplémentaires, consultez DrawText.
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows [Applications de bureau Vista uniquement] |
| Serveur minimal pris en charge |
Windows Serveur 2003 [ applications de bureau uniquement] |
| DLL |
|