mensaje de LVM_INSERTITEM

Inserta un nuevo elemento en un control de vista de lista. Puede enviar este mensaje explícitamente o mediante la macro ListView_InsertItem .

Parámetros

wParam

Debe ser cero.

lParam

Puntero a una estructura LVITEM que especifica los atributos del elemento de vista de lista. Use el miembro iItem para especificar el índice de base cero en el que se debe insertar el nuevo elemento. Si este valor es mayor que el número de elementos contenidos actualmente en la vista de lista, el nuevo elemento se anexará al final de la lista y se asignará el índice correcto. Examine el valor devuelto del mensaje para determinar el índice real asignado al elemento.

Valor devuelto

Devuelve el índice del nuevo elemento si se ejecuta correctamente o -1 de lo contrario.

Observaciones

No puede usar ListView_InsertItem ni LVM_INSERTITEM para insertar subelementos. El miembro iSubItem de la estructura LVITEM debe ser cero. Consulte LVM_SETITEM para obtener información sobre cómo establecer subelementos.

Si un control de vista de lista tiene establecido el estilo LVS_EX_CHECKBOXES , se omitirá cualquier valor colocado en bits de 12 a 15 del miembro de estado de la estructura LVITEM . Cuando se agrega un elemento con este conjunto de estilos, siempre se establecerá en el estado no activado.

Si un control de vista de lista tiene el estilo de ventana LVS_SORTASCENDING o LVS_SORTDESCENDING , se producirá un error en un mensaje de LVM_INSERTITEM si intenta insertar un elemento que tiene LPSTR_TEXTCALLBACK como valor para su miembro pszText .

El mensaje LVM_INSERTITEM insertará el nuevo elemento en la posición adecuada en el criterio de ordenación si las condiciones siguientes contienen:

• Está usando uno de los estilos de LVS_SORTXXX.
• No está usando el estilo LVS_OWNERDRAW .
• El miembro pszText de la estructura a la que apunta pitem no se establece en LPSTR_TEXTCALLBACK.

Si la estructura LVITEM no contiene LVIF_GROUPID en el miembro mask , el valor del miembro iGroupId se I_GROUPIDCALLBACK de forma predeterminada.

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	Commctrl.h
Nombres Unicode y ANSI	LVM_INSERTITEMW (Unicode) y LVM_INSERTITEMA (ANSI)