EM_LIMITTEXT message

Définit la limite de texte d’un contrôle d’édition. La limite de texte correspond à la quantité maximale de texte, en TCHAR, que l’utilisateur peut taper dans le contrôle d’édition. Vous pouvez envoyer ce message à un contrôle d’édition ou à un contrôle d’édition enrichi.

Pour les contrôles d’édition et Microsoft Rich Edit 1.0, les octets sont utilisés. Pour Microsoft Rich Edit 2.0 et versions ultérieures, des caractères sont utilisés.

Paramètres

wParam

Nombre maximal de TCHARque l’utilisateur peut entrer. Pour le texte ANSI, il s’agit du nombre d’octets ; pour le texte Unicode, il s’agit du nombre de caractères. Ce nombre n’inclut pas le caractère null de fin.

Contrôles d’édition enrichis : Si ce paramètre est égal à zéro, la longueur du texte est définie sur 64 000 caractères.

Si ce paramètre est égal à zéro, la longueur du texte est définie sur 0x7FFFFFFE caractères pour les contrôles d’édition à une seule ligne ou -1 pour les contrôles d’édition multiligne.

lParam

Ce paramètre n'est pas utilisé.

Valeur retournée

Ce message ne retourne pas de valeur.

Notes

Le message EM_LIMITTEXT limite uniquement le texte que l’utilisateur peut entrer. Cela n’affecte pas le texte déjà contenu dans le contrôle d’édition lors de l’envoi du message, ni la longueur du texte copié dans le contrôle d’édition par le WM_SETTEXT message. Si une application utilise le message WM_SETTEXT pour placer plus de texte dans un contrôle d’édition que ce qui est spécifié dans le message EM_LIMITTEXT , l’utilisateur peut modifier l’intégralité du contenu du contrôle d’édition.

Avant d’appeler EM_LIMITTEXT , la limite par défaut de la quantité de texte qu’un utilisateur peut entrer dans un contrôle de modification est de 32 767 caractères.

Pour les contrôles de modification d’une seule ligne, la limite de texte est 0x7FFFFFFE octets ou la valeur du paramètre wParam , selon la plus petite des deux. Pour les contrôles d’édition multiligne, cette valeur est -1 octet ou la valeur du paramètre wParam , selon la valeur la plus petite.

Modification enrichie : Pris en charge dans Microsoft Rich Edit 1.0 et versions ultérieures. Utilisez le message EM_EXLIMITTEXT pour les valeurs de longueur de texte supérieures à 64 000. Pour plus d’informations sur la compatibilité des versions d’édition enrichie avec les différentes versions du système, consultez À propos des contrôles d’édition enrichi.

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

EM_EXLIMITTEXT

Edit_LimitText

Autres ressources

WM_SETTEXT