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 |