macro ListView_SetItemState (commctrl.h)

Artículo
08/22/2023

Cambia el estado de un elemento en un control de vista de lista. Puede usar esta macro o enviar el mensaje LVM_SETITEMSTATE explícitamente.

Sintaxis

void ListView_SetItemState(
   hwndLV,
   i,
   data,
   mask
);

Parámetros

hwndLV

Tipo: HWND

Identificador del control de vista de lista.

i

Tipo: int

Índice del elemento de vista de lista. Si este parámetro es -1, el cambio de estado se aplica a todos los elementos.

data

Tipo: UINT

Nuevos bits de estado para el elemento. El parámetro mask indica los bits válidos del parámetro de estado . La macro omite los bits del parámetro de estado si el bit correspondiente no está establecido en el parámetro mask . El byte de orden bajo contiene un conjunto de marcas de bits que indican el estado del elemento. Este byte puede ser una combinación de los valores siguientes:

Valor	Significado
LVIS_CUT	El elemento está marcado para una operación de cortar y pegar.
LVIS_DROPHILITED	El elemento se resalta como destino de arrastrar y colocar.
LVIS_FOCUSED	El elemento tiene el foco, por lo que está rodeado por un rectángulo de foco estándar. Aunque se puede seleccionar más de un elemento, solo un elemento puede tener el foco.
LVIS_SELECTED	El elemento está seleccionado. La apariencia de un elemento seleccionado depende de si tiene el foco y también de los colores del sistema usados para la selección. Los elementos solo se mostrarán como seleccionados si el control de vista de lista tiene el foco o se usa el estilo LVS_SHOWSELALWAYS .

mask

Tipo: UINT

Bits del parámetro de estado que desea establecer o borrar. Puede usar ListView_SetItemState para establecer y borrar bits. Para establecer el índice de imagen de superposición de un elemento, establezca los bits de LVIS_OVERLAYMASK . Para establecer el índice de imagen de estado de un elemento, establezca los bits de LVIS_STATEIMAGEMASK .

Valor devuelto

None

Observaciones

El valor de estado de un elemento incluye un conjunto de marcas de bits que indican el estado del elemento. El valor de estado también puede incluir índices de lista de imágenes que indican la imagen de estado y la imagen de superposición del elemento.

El parámetro mask especifica los bits de estado que desea modificar y el parámetro state especifica el nuevo valor para esos bits. Para establecer un bit en el estado interno del elemento, establézcalo en los parámetros mask y state . Para borrar un poco en el estado interno del elemento, establézcalo en el parámetro mask y nítelo en el parámetro de estado . Para dejar un poco sin cambios en el estado interno del elemento, desactive el parámetro mask .

Los bits de 8 a 11 del parámetro de estado especifican el índice basado en uno de una imagen de superposición en las listas de imágenes del control. Tanto la lista de imágenes de icono de tamaño completo como la lista de imágenes de icono pequeña pueden tener imágenes superpuestas. La imagen de superposición se superpone sobre la imagen de icono del elemento. Si estos bits son cero, el elemento no tiene ninguna imagen de superposición. Para aislar estos bits, use la máscara de LVIS_OVERLAYMASK . Para especificar un índice de superposición, use la macro INDEXTOOVERLAYMASK .

Los bits de 12 a 15 del parámetro de estado especifican el índice basado en uno de una imagen en la lista de imágenes de estado del control. La imagen de estado se muestra junto al icono de un elemento para indicar un estado definido por la aplicación. Si estos bits son cero, el elemento no tiene ninguna imagen de estado. Para aislar estos bits, use la máscara de LVIS_STATEIMAGEMASK . Para especificar un índice de imagen de estado, use la macro INDEXTOSTATEIMAGEMASK .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	commctrl.h

Consulte también

ListView_GetItemState