mensaje de LVM_SETITEM

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

Parámetros

wParam

Debe ser cero.

lParam

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

Devuelve TRUE si es correcto o FALSE en caso contrario.

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 establecer los miembros state, pszText, iImage y lParam de la estructura LVITEM .

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]
Encabezado
Commctrl.h
Nombres Unicode y ANSI
LVM_SETITEMW (Unicode) y LVM_SETITEMA (ANSI)