mensaje de LB_ADDSTRING

Agrega una cadena a un cuadro de lista. Si el cuadro de lista no tiene el estilo LBS_SORT , la cadena se agrega al final de la lista. De lo contrario, la cadena se inserta en la lista y la lista se ordena.

Parámetros

wParam

Este parámetro no se utiliza.

lParam

Puntero a la cadena terminada en null que se va a agregar.

Si el cuadro de lista tiene un estilo dibujado por el propietario, pero no el estilo LBS_HASSTRINGS , este parámetro se almacena como datos de elemento en lugar de una cadena. Puede enviar los mensajes LB_GETITEMDATA y LB_SETITEMDATA para recuperar o modificar los datos del elemento.

Valor devuelto

El valor devuelto es el índice de base cero de la cadena en el cuadro de lista. Si se produce un error, el valor devuelto es LB_ERR. Si no hay espacio suficiente para almacenar la nueva cadena, el valor devuelto es LB_ERRSPACE.

Comentarios

Si el cuadro de lista tiene un estilo dibujado por el propietario y el estilo LBS_SORT , pero no el estilo LBS_HASSTRINGS , el sistema envía el mensaje WM_COMPAREITEM una o varias veces al propietario del cuadro de lista para colocar el nuevo elemento correctamente en el cuadro de lista.

El mensaje LB_INITSTORAGE ayuda a acelerar la inicialización de cuadros de lista que tienen un gran número de elementos (más de 100). Reserva la cantidad de memoria especificada para que los mensajes de LB_ADDSTRING posteriores tarden el menor tiempo posible. Puede usar estimaciones para los parámetros wParam y lParam . Si se sobrestima, se asigna la memoria adicional; si subestima, la asignación normal se usa para los artículos que superan la cantidad solicitada.

Si el cuadro de lista tiene el estilo WS_HSCROLL y agrega una cadena más ancha que el cuadro de lista, envíe un mensaje LB_SETHORIZONTALEXTENT para asegurarse de que aparece la barra de desplazamiento horizontal.

Para una aplicación ANSI, el sistema convierte el texto de un cuadro de lista en Unicode mediante CP_ACP. Esto puede causar problemas. Por ejemplo, los caracteres romanos acentuados en un cuadro de lista que no sea Unicode en Windows japonés aparecerán desagrados. Para corregirlo, compile la aplicación como Unicode o use un cuadro de lista dibujado por el propietario.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	Winuser.h (incluye Windows.h)

Consulte también

Referencia

LB_DELETESTRING

LB_INSERTSTRING

LB_SELECTSTRING

LB_SETHORIZONTALEXTENT

WM_COMPAREITEM