Macro ListView_SetItem

Asigna alguno o todos los atributos de un ítem de un list-view. Se puede usar esta macro o enviar el mensaje LVM_SETITEM explícitamente.

Definición

BOOL ListView_SetItem(
    HWND hwnd,
    const LPLVITEM pitem
);

Descripción

hwnd

Un manipulador del control list-view.

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.