message EM_SETLIMITTEXT

Définit la limite de texte d’un contrôle d’édition. La limite de texte correspond à la quantité maximale de texte, dans TCHARs, 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, les caractères sont utilisés.

Le message EM_SETLIMITTEXT est identique au message EM_LIMITTEXT .

Paramètres

wParam

Nombre maximal de TCHAR que 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 monoligne 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. Il n’affecte aucun texte déjà dans le contrôle d’édition lorsque le message est envoyé, ni la longueur du texte copié dans le contrôle d’édition par le message WM_SETTEXT . Si une application utilise le message WM_SETTEXT pour placer plus de texte dans un contrôle d’édition que celui spécifié dans le message EM_SETLIMITTEXT , l’utilisateur peut modifier l’intégralité du contenu du contrôle d’édition.

Avant d’appeler EM_SETLIMITTEXT , la limite par défaut pour 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 d’édition monoligne, la limite de texte est soit 0x7FFFFFFE octets, soit la valeur du paramètre wParam , selon la valeur la plus petite. Pour les contrôles d’édition multiligne, cette valeur est de 1 octets 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 enrichies avec les différentes versions système, consultez À propos des contrôles Rich Edit.

Configuration requise

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 (include Windows.h)

Voir aussi

EM_GETLIMITTEXT