mensaje de LB_INSERTSTRING

  • Artículo

Inserta datos de cadena o elemento en un cuadro de lista. A diferencia del mensaje LB_ADDSTRING , el mensaje de LB_INSERTSTRING no hace que se ordene una lista con el estilo de LBS_SORT .

Parámetros

wParam

Índice de base cero de la posición en la que se va a insertar la cadena. Si este parámetro es -1, la cadena se agrega al final de la lista.

lParam

Puntero a la cadena terminada en null que se va a insertar. 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 la posición en la que se insertó la cadena. Si se produce un error, el valor devuelto es LB_ERR. Si no hay espacio suficiente para almacenar la nueva cadena, se LB_ERRSPACE el valor devuelto.

Comentarios

El LB_INITSTORAGE mensaje 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_INSERTSTRING 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 elementos que superan la cantidad solicitada.

Si el cuadro de lista tiene WS_HSCROLL estilo e inserta 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 no 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_ADDSTRING

LB_SELECTSTRING

LB_SETHORIZONTALEXTENT