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 |