ListView_InsertItem macro (commctrl.h)

Inserta un nuevo elemento en un control de vista de lista. Puede usar esta macro o enviar explícitamente el mensaje de LVM_INSERTITEM .

Sintaxis

void ListView_InsertItem(
   hwnd,
   pitem
);

Parámetros

hwnd

Tipo: HWND

Identificador del control de vista de lista.

pitem

Tipo: const LPLVITEM

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 el control listview, el nuevo elemento se anexará al final de la lista y se asignará el índice correcto. Examine el valor devuelto de la macro para determinar el índice real asignado al elemento.

Valor devuelto

None

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 desactivado.

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 miembro pszText de su estructura LVITEM .

La macro ListView_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 usa el estilo LVS_OWNERDRAW.
• El miembro pszText de la estructura a la que apunta pitem no se establece en LPSTR_TEXTCALLBACK.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	commctrl.h