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 explícitamente el mensaje LVM_SETITEM .

Sintaxis

void ListView_SetItem(
   hwnd,
   pitem
);

Parámetros

hwnd

Tipo: HWND

Identificador del control de vista de lista.

pitem

Tipo: const LPLVITEM

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

Valor devuelto

None

Observaciones

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

Para establecer el texto de un subelemento, establezca los miembros iItem e 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 pueden establecer los miembros state o 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

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