messaggio EM_SETLIMITTEXT

Imposta il limite di testo di un controllo di modifica. Il limite di testo è la quantità massima di testo, in TCHARs, che l'utente può digitare nel controllo di modifica. È possibile inviare questo messaggio a un controllo di modifica o a un controllo di modifica avanzato.

Per i controlli di modifica e Microsoft Rich Edit 1.0, vengono usati byte. Per Microsoft Rich Edit 2.0 e versioni successive, vengono usati caratteri.

Il messaggio EM_SETLIMITTEXT è identico al messaggio EM_LIMITTEXT .

Parametri

wParam

Il numero massimo di TCHARpuò essere immesso dall'utente. Per il testo ANSI, si tratta del numero di byte; per il testo Unicode, si tratta del numero di caratteri. Questo numero non include il carattere Null terminante.

Controlli di modifica avanzati: Se questo parametro è zero, la lunghezza del testo è impostata su 64.000 caratteri.

Se questo parametro è zero, la lunghezza del testo è impostata su 0x7FFFFFFE caratteri per i controlli di modifica a riga singola o 1 per i controlli di modifica multilinea.

lParam

Questo parametro non viene usato.

Valore restituito

Questo messaggio non restituisce un valore.

Commenti

Il messaggio di EM_SETLIMITTEXT limita solo il testo che l'utente può immettere. Non influisce sul testo già presente nel controllo di modifica quando il messaggio viene inviato, né influisce sulla lunghezza del testo copiato nel controllo di modifica dal messaggio di WM_SETTEXT . Se un'applicazione usa il messaggio di WM_SETTEXT per inserire più testo in un controllo di modifica specificato nel messaggio EM_SETLIMITTEXT, l'utente può modificare l'intero contenuto del controllo di modifica.

Prima di chiamare EM_SETLIMITTEXT , il limite predefinito per la quantità di testo che un utente può immettere in un controllo di modifica è di 32.767 caratteri.

Per i controlli di modifica a riga singola, il limite di testo è 0x7FFFFFFE byte o il valore del parametro wParam , che tuttavia è più piccolo. Per i controlli di modifica multilinea, questo valore è 1 byte o il valore del parametro wParam , che tuttavia è più piccolo.

Modifica avanzata: Supportato in Microsoft Rich Edit 1.0 e versioni successive. Usare il messaggio EM_EXLIMITTEXT per i valori di lunghezza del testo superiori a 64.000. Per informazioni sulla compatibilità delle versioni di modifica avanzate con le varie versioni di sistema, vedere Informazioni sui controlli di modifica avanzati.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	Winuser.h (include Windows.h)

Vedi anche

EM_GETLIMITTEXT