Compartir a través de


CListCtrl::SetItemState

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.

Ejemplo

Vea el ejemplo para CListCtrl:: GetTopIndex.

Requisitos

encabezado: afxcmn.h

Vea también

Referencia

CListCtrl Class

Gráfico de jerarquías

CListCtrl::GetItemState