CListCtrl::SetItemState

Artículo
02/19/2013

Cambia el estado de un elemento en un control de vista de lista.

BOOL SetItemState(
   int nItem,
   LVITEM* pItem 
);
BOOL SetItemState(
   int nItem,
   UINT nState,
   UINT nMask 
);

Parámetros

nItem
Índice del elemento cuyo estado debe establecer.
pItem
Dirección de una estructura de LVITEM , como se describe en Windows SDK.El miembro de stateMask de estructura especifica que indica los bits para cambiar, y el miembro de Estado de estructura contiene los nuevos valores para esos bits.Se omiten los otros miembros.
nState
Valores nuevos de los bits del estado.Para obtener una lista de valores posibles, vea CListCtrl::GetNextItem y el miembro de estado de LVITEM .
nMask
La especificación de máscara que indican los bits para cambiar.Este valor corresponde al miembro del stateMask de la estructura de LVITEM .

Valor devuelto

Distinto de cero si correctamente; si no cero.

Comentarios

La “estado” de un elemento es un valor que especifica la disponibilidad del elemento, indica las acciones del usuario, o refleja de otra forma el estado del elemento.Los cambios de un control de vista de lista algunos indican los bits, por ejemplo cuando el usuario seleccione un elemento.Una aplicación puede cambiar otros bits de estado para deshabilitar u ocultar el elemento, o para especificar una imagen de grafía o to imagen.