macro ListView_SetItemState (commctrl.h)

  • Artículo

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(
   HWND hwndLV,
   int  i,
   UINT data,
   UINT mask
);

Parámetros

hwndLV

Tipo: HWND

Identificador del control list-view.

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 de

Nuevos bits de estado para el elemento. El parámetro mask indica los bits válidos del parámetro de datos de . La macro omite los bits del parámetro datos si el bit correspondiente no está establecido en el parámetro mask de . 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 siguientes valores:

Valor Significado
LVIS_CUT
 El elemento está marcado para una operación de corte y pegado.
LVIS_DROPHILITED
 El elemento se resalta como un 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 de

Bits del parámetro datos 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 LVIS_STATEIMAGEMASK.

Valor devuelto

Ninguno

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 datos especifica el nuevo valor para esos bits. Para establecer un bit en el estado interno del elemento, establézcalo en los parámetros de máscara de y datos. Para borrar un poco en el estado interno del elemento, establézcalo en el parámetro mask y desactive en el parámetro datos. Para dejar un poco sin cambios en el estado interno del elemento, desactive en el parámetro mask.

Los bits de 8 a 11 de los datos de parámetro especifican el índice basado en 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ño 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 de los datos de parámetro especifican el índice basado en una imagen de 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 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

Consulte también

ListView_GetItemState