macro ListView_SetItem (commctrl.h)

Establece algunos o todos los atributos de un elemento de vista de lista. También puede usar ListView_SetItem para establecer el texto de un subelemento. Puede usar esta macro o enviar el mensaje LVM_SETITEM explícitamente.

Sintaxis

BOOL ListView_SetItem(
         HWND     hwnd,
   const LPLVITEM pitem
);

Parámetros

hwnd

Tipo: HWND

Identificador del control list-view.

pitem

Tipo: const LPLVITEM

Puntero a una estructura LVITEM de que contiene los nuevos atributos de elemento. El iItem y miembros iSubItem identifican el elemento o el subelemento, y el miembro mask especifica qué atributos se van a establecer. Si el miembro mask especifica el valor de LVIF_TEXT, el miembro pszText es la dirección de una cadena terminada en null y se omite el miembro cchTextMax. Si la máscara miembro especifica el valor LVIF_STATE, el miembro stateMask especifica qué estados de elemento se van a cambiar y el miembro estado contiene los valores de esos estados.

Valor devuelto

Tipo: BOOL de

Devuelve TRUE si se ejecuta correctamente o FALSE de lo contrario.

Observaciones

Para establecer los atributos de un elemento de vista de lista, establezca el miembro iItem de la estructura LVITEM de en el índice del elemento y establezca el miembro iSubItem en cero. Para un elemento, puede usar el estado de , pszText, iImagey miembros lParam de la estructura LVITEM para modificar estos parámetros de elemento.

Para establecer el texto de un subelemento, establezca el iItem y miembros iSubItem para indicar el subelemento específico y use el miembro pszText para especificar el texto. Como alternativa, puede usar la macro ListView_SetItemText para establecer el texto de un subelemento. No se puede establecer el estado de ni miembros de lParam para subelementos porque los subelementos no tienen estos atributos. En la versión 4.70 y posteriores, puede establecer el miembro iImage para subelementos. La imagen del subelemento se mostrará si el control de vista de lista tiene el estilo extendido LVS_EX_SUBITEMIMAGES. Las versiones anteriores omitirán la imagen del subelemento.

Requisitos