CB_ADDSTRING mensaje

  • Artículo

Agrega una cadena en el cuadro de lista de un cuadro combinado. Si el cuadro combinado no tiene el estilo CBS_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 LPCTSTR a la cadena terminada en null que se va a agregar. Si crea el cuadro combinado con un estilo dibujado por el propietario, pero sin el estilo CBS_HASSTRINGS , el valor del parámetro lParam se almacena como datos de elemento en lugar de la cadena a la que apuntaría de otro modo. Los datos del elemento se pueden recuperar o modificar enviando el mensaje CB_GETITEMDATA o CB_SETITEMDATA .

Valor devuelto

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

Observaciones

Si crea un cuadro combinado dibujado por el propietario con el estilo CBS_SORT pero sin el estilo CBS_HASSTRINGS , el mensaje de WM_COMPAREITEM se envía una o varias veces al propietario del cuadro combinado para que el nuevo elemento pueda colocarse correctamente en la lista.

Para insertar una cadena en una ubicación específica dentro de la lista, use el mensaje CB_INSERTSTRING .

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

Comclt32.dll versión 5.0 o posterior: Si se establece CBS_LOWERCASE o CBS_UPPERCASE , la versión Unicode de CB_ADDSTRING modifica la cadena. Si usa memoria global de solo lectura, esto hace que se produzca un error en la aplicación.

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

CB_DIR

CB_INSERTSTRING

LB_SETHORIZONTALEXTENT

WM_COMPAREITEM