EM_SETLIMITTEXT 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.

Le message EM_SETLIMITTEXT est identique au message EM_LIMITTEXT .

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 sur 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_SETLIMITTEXT 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_SETLIMITTEXT , l’utilisateur peut modifier l’intégralité du contenu du contrôle de modification.

Avant d’appeler EM_SETLIMITTEXT , la limite par défaut de la quantité de texte qu’un utilisateur peut entrer dans un contrôle d’édition 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 multilignes, cette valeur est de 1 octet ou de 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

EM_GETLIMITTEXT