macro TreeView_SetCheckState (commctrl.h)

Establece la imagen de estado del elemento en "checked" o "unchecked". También puede usar directamente el mensaje TVM_SETITEM.

Sintaxis

UINT TreeView_SetCheckState(
   HWND      hwndTV,
   HTREEITEM hti,
   BOOL      fCheck
);

Parámetros

hwndTV

Tipo: HWND

Identificador del control de vista de árbol.

hti

Tipo: HTREEITEM

Identificador del elemento.

fCheck

Tipo: BOOL de

Valor que indica qué imagen de estado se muestra. Establezca fCheck en TRUE para mostrar la imagen de estado activada o FALSE para mostrar la imagen desactivada.

Valor devuelto

Tipo: UINT de

No se usa el valor devuelto.

Observaciones

Un control de vista de árbol puede tener dos listas de imágenes. La lista de imágenes normales almacena las imágenes seleccionadas, no seleccionadas y superpuestas. Las casillas se almacenan en la lista de imágenes de estado y se muestran a la izquierda de la imagen normal correspondiente. Las imágenes de estado se especifican mediante un índice basado en uno. Un índice de cero indica que no hay ninguna imagen de estado. Consulte Tree-View listas de imágenes para obtener información sobre cómo controlar las imágenes de vista de árbol.

Si desea definir sus propias imágenes de estado, esta macro supone que las imágenes activadas y desactivadas tienen los mismos índices que la lista de imágenes estándar: 1 para desmarcado y 2 para comprobado.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	commctrl.h