messaggio di LB_GETTEXTLEN

Ottiene la lunghezza di una stringa in una casella di riepilogo.

Parametri

wParam

Indice in base zero della stringa.

Windows 95/Windows 98/Windows Millennium Edition (Windows Me): il parametro wParam è limitato a valori a 16 bit. Ciò significa che le caselle di riepilogo non possono contenere più di 32.767 elementi. Anche se il numero di elementi è limitato, la dimensione totale in byte degli elementi in una casella di riepilogo è limitata solo dalla memoria disponibile.

lParam

Questo parametro non viene usato.

Valore restituito

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

Se il parametro wParam non specifica un indice valido, il valore restituito viene LB_ERR.

Commenti

In determinate condizioni, il valore restituito è maggiore della lunghezza effettiva del testo. Ciò si verifica con determinate combinazioni di CARATTERI ANSI e Unicode ed è dovuto al sistema operativo che consente l'esistenza possibile di caratteri DBCS (Double-Byte Character Set) all'interno del testo. Il valore restituito, tuttavia, sarà sempre pari almeno alla lunghezza effettiva del testo; è quindi sempre possibile usarlo 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 il WM_GETTEXT, LB_GETTEXT o CB_GETLBTEXT messaggi o la funzione GetWindowText .

Se la casella di riepilogo ha uno stile disegnato dal proprietario, ma non lo stile di LBS_HASSTRINGS , il valore restituito è sempre la dimensione, espressa in byte, di una DWORD.

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

Riferimento

CB_GETLBTEXT

LB_GETTEXT

Altre risorse

GetWindowText

WM_GETTEXT