LB_GETTEXTLEN

Un'applicazione invia un messaggio di LB_GETTEXTLEN per recuperare la lunghezza di una stringa in una casella di riepilogo.

LB_GETTEXTLEN wParam = indice (WPARAM);    / / voce indice lParam = 0;                 / / non utilizzate; deve essere zero 
 

Parametri

indice
Valore di wParam. Specifica l'indice in base zero della stringa.

Windows 95 e Windows 98: Il parametro wParam è limitato a valori a 16 bit. Questo significa caselle di riepilogo non possono contenere più di 32.767 elementi. Anche se il numero di elementi è limitato, la dimensione totale in byte gli elementi in una casella di riepilogo è limitata solo dalla memoria disponibile.

Valori restituiti

Il valore restituito è la lunghezza della stringa, in caratteri, escluso il carattere di terminazione null. In determinate condizioni, questo valore può effettivamente essere maggiore della lunghezza del testo. Per ulteriori informazioni, vedere la sezione Osservazioni seguente.

Se il parametro index non è specificato un indice valido, il valore restituito è LB_ERR.

Osservazioni

In determinate condizioni, il valore restituito è più grande rispetto alla lunghezza effettiva del testo. Questo si verifica con alcune miscele di ANSI e Unicode ed è dovuta al sistema operativo che consente la possibile esistenza di set di caratteri a doppio byte (DBCS) caratteri all'interno del testo. Il valore restituito, tuttavia, sarà sempre grande almeno quanto la lunghezza effettiva del testo; è possibile quindi sempre utilizzarlo per guidare l'allocazione del buffer. Questo problema può verificarsi quando un'applicazione utilizza sia funzioni ANSI e finestre di dialogo comuni, che utilizzano Unicode.

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

Descrizione

nbsp; Windows &NT: richiede 3.1 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Richiede la versione 1.0 o successiva.
Intestazione:Dichiarata in winuser.

Vedi anche

Elenco caselle panoramica, elenco casella messaggi, CB_GETLBTEXT, GetWindowText, LB_GETTEXT, WM_GETTEXT

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index