Mensaje LB_ADDSTRING

Definición

LB_ADDSTRING
wParam = 0;                 // no se usa; debe ser cero
lParam = (LPARAM)(LPCTSTR); // dirección de la cadena a añadir

Una aplicación envía un mensaje LB_ADDSTRING para añadir una cadena a un list box. Si el list box no tiene el estilo LBS_SORT, la cadena se añade al final de la lista. En otro caso, la cadena se inserta en la lista de modo que permanezca ordenada.

Descripción

lpsz: valor de lParam. Apunta a la cadena terminada con cero que será añadida.

Si se crea un list box con el estilo owner-drawn pero sin el estilo LBS_HASSTRINGS, el valor del parámetro lpsz es almacenado como un dato de ítem en lugar de la cadena a la que de otro modo apuntaría. Se pueden enviar los mensajes LB_GETITEMDATA y LB_SETITEMDATA para recuperar o modificar el datp de ítem.

Valor de retorno

El valor de retorno es el índice de la cadena en el listbox, los valores del índice empiezan en cero. Si ocurre un error, el valor de retorno es LB_ERR. Si no hay suficiente espacio para almacenar la nueva cadena, el valor de retorno será LB_ERRSPACE.

Observaciones

Si se crea un listbox owner-drawn con el estilo LBS_SORT pero sin el estilo LBS_HASSTRINGS, el sistema envía el mensaje WM_COMPAREITEM una o más veces a la ventana padre del list box para colocar el nuevo elemento en el lugar adecuado del list box.