Mensaje LVM_SETITEM

Definición

LVM_SETITEM
    pitem=(LPARAM)(const LPLVITEM)lParam

Asigna alguno o todos los atributos de un ítem de un list-view. Se puede enviar este mensaje explícitamente o bien usar la macro ListView_SetItem.

Descripción

pitem

Un puntero a una estructura LVITEM que contiene lso nuevos atributos del ítem. Los miembros iItem e iSubItem identifican el ítem o subítem, y el miembro mask especifica qué atributos asignar. Si el miembro mask especifica el valor LVIF_TEXT, el miembro pszText es la dirección de una cadena terminada en nulo y el miembro cchTextMax es ignorado. Si el miembro mask especifica el valor LVIF_STATE, el miembro stateMask especifica qué estados de ítem modificar, y el miembro state contiene contiene los valores para esos estados.

Valor de retorno

Devuelve TRUE si tiene éxito o FALSE en caso contrario.

Observaciones

Para asignar los atributos de un ítem de un list-view, asignar al miembro iItem de la estructura LVITEM el índice del ítem, y al miembro iSubItem el valor cero. Para un ítem se pueden usar los miembros state, pszText, iImage y lParam de la estructura LVITEM para modificar esos parámetros.

Para asignar el texto de un subítem, asignar los miembros iItem e iSubItem para indicar el subítem específico, y usar el miembro pszText con el texto deseado. Alternativamente, se puede usar la macro ListView_SetItemText para asignar el texto de un subítem. No se pueden asignar los miembros state o lParam para subítems, ya que no tienen esos atributos. A partir de la versión 4.70 en adelante, se puede asignar el miembro iImage para subítems. La imagen del subítem será mostrada si el control list-view tiene el estilo extendido LVS_EX_SUBITEMIMAGES. Las versiones anteriores ignoran la imagen del subítem.