messaggio WM_GETTEXTLENGTH

Determina la lunghezza, in caratteri, del testo associato a una finestra.

#define WM_GETTEXTLENGTH                0x000E

Parametri

wParam

Questo parametro non viene usato e deve essere zero.

lParam

Questo parametro non viene usato e deve essere zero.

Valore restituito

Tipo: LRESULT

Il valore restituito è la lunghezza del testo in caratteri, non incluso il carattere null terminante.

Commenti

Per un controllo di modifica, il testo da copiare è il contenuto del controllo di modifica. Per una casella combinata, il testo è il contenuto della parte di controllo di modifica (o testo statico) della casella combinata. Per un pulsante, il testo è il nome del pulsante. Per altre finestre, il testo è il titolo della finestra. Per determinare la lunghezza di un elemento in una casella di riepilogo, un'applicazione può usare il messaggio di LB_GETTEXTLEN .

Quando viene inviato il messaggio di WM_GETTEXTLENGTH , la funzione DefWindowProc restituisce la lunghezza, in caratteri, del testo. In determinate condizioni, la funzione DefWindowProc restituisce un valore maggiore della lunghezza effettiva del testo. Ciò si verifica con determinate combinazioni di CARATTERI ANSI e Unicode ed è dovuto al sistema che consente l'esistenza possibile di caratteri dbCS (Double Byte Character Set) all'interno del testo. Il valore restituito, tuttavia, sarà sempre maggiore della lunghezza effettiva del testo; è quindi possibile usarlo sempre per guidare l'allocazione del buffer. Questo comportamento può verificarsi quando un'applicazione usa sia funzioni ANSI che dialoghi comuni, che usano Unicode.

Per ottenere la lunghezza esatta del testo, usare la WM_GETTEXT, la LB_GETTEXT o i messaggi CB_GETLBTEXT o la funzione GetWindowText .

L'invio di un messaggio di WM_GETTEXTLENGTH a un controllo statico non testuale, ad esempio una bitmap statica o un controllo icona statica, non restituisce un valore stringa. Restituisce invece zero.

Requisiti

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

Vedi anche

Riferimento

DefWindowProc

GetWindowText

GetWindowTextLength

WM_GETTEXT

Informazioni concettuali

Windows

Altre risorse

CB_GETLBTEXT

LB_GETTEXT

LB_GETTEXTLEN