Fonction DrawTextExPrivWrap
[DrawTextExPrivWrap est disponible via Windows XP avec Service Pack 2 (SP2). Il peut être modifié ou indisponible dans les versions ultérieures. Il est recommandé d’utiliser DrawTextEx directement à la place.]
Dessine le texte mis en forme dans le rectangle spécifié. Cette fonction encapsule un appel à DrawTextEx.
Syntaxe
int WINAPI DrawTextExPrivWrap(
_In_ HDC hdc,
_Inout_ LPTSTR lpchText,
_In_ int cchText,
_Inout_ LPRECT lprc,
_In_ UINT dwDTFormat,
_In_ LPDRAWTEXTPARAMS lpDTParams
);
Paramètres
-
hdc [in]
-
Type : HDC
Handle du contexte de l’appareil dans lequel dessiner.
-
lpchText [in, out]
-
Type : LPTSTR
Pointeur vers une mémoire tampon qui contient le texte à dessiner. Si le paramètre cchText a la valeur -1, la chaîne doit être terminée par null.
Si dwDTFormat inclut 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 accueillir ces caractères supplémentaires.
-
cchText [in]
-
Type : int
Longueur de la chaîne pointée par lpchText. Si cchText a la valeur -1, le paramètre lpchText est supposé être un pointeur vers une chaîne terminée par null et DrawTextEx calcule automatiquement le nombre de caractères.
-
lprc [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.
-
dwDTFormat [in]
-
Type : UINT
Options de mise en forme. Consultez la documentation de DrawTextEx pour obtenir la liste complète des options.
-
lpDTParams [in]
-
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 retournée
Type : int
Si la fonction réussit, 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 entre le membre supérieur de lprc et le bas du texte dessiné.
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
DrawTextExPrivWrap n’est pas exporté par nom ou déclaré dans un fichier d’en-tête public. Pour l’utiliser, vous devez utiliser GetProcAddress et demander l’ordinal 416 à partir de ComCtl32.dll pour obtenir un pointeur de fonction.
Pour plus d’informations, consultez DrawTextEx.
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Windows Server 2003 [applications de bureau uniquement] |
| DLL |
|