Mensaje LB_GETTEXT

Definición

LB_GETTEXT
wParam = (WPARAM) index;                 // índice del ítem
lParam = (LPARAM) (LPCTSTR) lpszBuffer;  // dirección del buffer

Una aplicación envía un mensaje LB_GETTEXT para recuperar una cadena desde un list box.

Descripción

index: valor de wParam. Especifica el índice, comenzando en cero, de la cadena a recuperar.

Windows 95: el parámetro wParam está limitado a valores de 16 bits. Esto significa que los list box no pueden contener más de 32767 ítems. Aunque el número de ítems está limitado, el tamaño total en bytes de los ítems en un list box está sólo limitado por la memoria disponible.

lpszBuffer: valor de lParam. Apunta al buffer que recibirá la cadena. El buffer deberá tener el suficiente espacio para la cadena y el carácter nulo de terminación. Se puede enviar un mensaje LB_GETTEXTLEN antes del mensaje LB_GETTEXT para averiguar la longitud, en caracteres, de la cadena.

Valor de retorno

El valor de retorno en la longitud de la cadena, en caracteres, excluyendo el terminador nulo. Si el parámetro index no especifica un índice válido, el valor de retorno es LB_ERR.

Observaciones

Si se crea un list box con el estilo owner-drawn pero sin el estilo LBS_HASSTRINGS, el buffer apuntado por el parámetro lpszBuffer recibirá el valor de 32 bits asociado con el ítem, (el item data).