LB_GETTEXTLEN message

Obtient la longueur d’une chaîne dans une zone de liste.

Paramètres

wParam

Index de base zéro de la chaîne.

Windows 95/Windows 98/Windows Millennium Edition (Windows Me) : le paramètre wParam est limité aux valeurs 16 bits. Cela signifie que les zones de liste ne peuvent pas contenir plus de 32 767 éléments. Bien que le nombre d’éléments soit limité, la taille totale en octets des éléments d’une zone de liste est limitée uniquement par la mémoire disponible.

lParam

Ce paramètre n'est pas utilisé.

Valeur retournée

La valeur de retour est la longueur de la chaîne, en TCHARs, à l’exclusion du caractère null de fin. Dans certaines conditions, cette valeur peut être supérieure à la longueur du texte. Pour plus d'informations, consultez la section Notes qui suit.

Si le paramètre wParam ne spécifie pas d’index valide, la valeur de retour est LB_ERR.

Notes

Dans certaines conditions, la valeur de retour est supérieure à la longueur réelle du texte. Cela se produit avec certains mélanges d’ANSI et d’Unicode, et est dû au système d’exploitation permettant l’existence possible de caractères de jeu de caractères codés sur deux octets (DBCS) dans le texte. Toutefois, la valeur de retour sera toujours au moins aussi grande que la longueur réelle du texte ; vous pouvez donc toujours l’utiliser pour guider l’allocation de mémoire tampon. Ce comportement peut se produire lorsqu’une application utilise à la fois des fonctions ANSI et des boîtes de dialogue courantes, qui utilisent Unicode.

Pour obtenir la longueur exacte du texte, utilisez les messages WM_GETTEXT, LB_GETTEXT ou CB_GETLBTEXT , ou la fonction GetWindowText .

Si la zone de liste a un style dessiné par le propriétaire, mais pas le style LBS_HASSTRINGS , la valeur renvoyée est toujours la taille, en octets, d’un DWORD.

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]
En-tête
Winuser.h (inclure Windows.h)

Voir aussi

Référence

CB_GETLBTEXT

LB_GETTEXT

Autres ressources

GetWindowText

WM_GETTEXT