Compartir a través de

macro ListView_InsertItem (commctrl.h)

  • Artículo

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

Sintaxis

int ListView_InsertItem(
         HWND     hwnd,
   const LPLVITEM pitem
);

Parámetros

hwnd

Tipo: HWND

Identificador del control list-view.

pitem

Tipo: const LPLVITEM

Puntero a una estructura de 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 que contiene actualmente 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

Tipo: int

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

La macro ListView_InsertItem insertará el nuevo elemento en la posición adecuada en el criterio de ordenación si las condiciones siguientes contienen:

  • Usa 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 está establecido en LPSTR_TEXTCALLBACK.

Requisitos

Requisito Valor
cliente mínimo admitido Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de commctrl.h