Control ListView

El control ListView que muestra una columna de valores única con un icono junto a cada elemento. Permite al usuario seleccionar un valor entero o de cadena único para una propiedad de una lista predeterminada. Los valores posibles se leen de la tabla ListView. Para asociar el control con un valor entero o de cadena, escriba el nombre de la propiedad en la columna Property de la tabla Control.

El control ListView nunca muestra el contenido del campo Text de la tabla Control. En su lugar, este campo especifica el estilo de texto que va a mostrar el control y contiene una descripción del control utilizado por las herramientas de lectura de pantalla. Para establecer la fuente y el estilo de fuente de una cadena de texto, anteponga la cadena de caracteres mostrados con {\style} o {&style}. Donde style es un identificador que aparece en la columna TextStyle de la tabla TextStyle. Si no aparece ninguno de estos elementos, pero la propiedad DefaultUIFont está definida como un estilo de texto válido, se usará esa fuente. La siguiente información se lee mediante las herramientas de lectura de pantalla como la descripción del control. Consulte Accesibilidad.

Atributos de control

Puede usar los atributos siguientes con este control. Para cambiar el valor de un atributo mediante un evento, suscriba el control a un ControlEvent en la tabla EventMapping y enumere el identificador del atributo en la columna Attribute. Escriba el identificador de ControlEvent en la columna Event.

Identificador de atributo	Bit hexadecimal	Descripción
IndirectPropertyName		Este es el nombre de una propiedad indirecta asociada al control. Si se establece el bit de atributo indirecto, el control muestra o cambia el valor de la propiedad que tiene este nombre. Si se establece el bit de atributo indirecto, este nombre también es el valor de la propiedad que aparece en la columna Property de la tabla Control.
Posición		Posición del control en el cuadro de diálogo. Especifique el ancho, el alto y las coordenadas del control de la esquina izquierda del control en las columnas Width, Height, X e Y de la tabla Control. Use unidades del instalador para la longitud y la distancia.
PropertyName		Este es el nombre de la propiedad asociada a este control. Si no se establece el bit de atributo indirecto, el control muestra o cambia el valor de la propiedad que tiene este nombre. Este atributo se especifica en la columna Property de la tabla Control.
PropertyValue		Valor actual de la propiedad mostrada o modificada por este control. Si no se establece el bit de atributo Indirect, este es el valor de PropertyName. Si se establece el bit de atributo Indirect, este es el valor de IndirectPropertyName. Si el atributo cambia, el control refleja el nuevo valor.
Texto		Para mostrar texto en lectores de pantalla, escriba el texto en la columna Texto de la tabla Control. Consulte Accesibilidad.
Visible	0x00000000 0x00000001	Control oculto. Control visible. Incluya este bit en la palabra de bits de la columna Attributes de la tabla Control para que el control esté visible u oculto al crearlo. Un control se puede ocultar o mostrar también mediante la tabla ControlCondition.
Enabled	0x00000000 0x00000002	Control en estado deshabilitado. Control con el estado habilitado. Incluya este bit en la palabra de bits de la columna Attributes de la tabla Control para habilitar el control al crearlo. También se puede habilitar o deshabilitar un control mediante la tabla ControlCondition.
Sunken	0x00000000 0x00000004	Muestra el estilo visual predeterminado. Muestra el control con un aspecto 3D, con profundidad. Incluya estos bits en la palabra de bit de la columna Attributes de la tabla Control.
Indirecto	0x00000000 0x00000008	El control muestra o cambia el valor de la propiedad en la columna Property de la tabla Control. El control muestra o cambia el valor de la propiedad que tiene el identificador que aparece en la columna Property de la tabla Control. Determina si se hace referencia indirectamente a la propiedad asociada a este control.
Entero	0x00000000 0x00000010	La propiedad asociada al control es un valor de cadena. La propiedad asociada al control es un valor entero. Incluya este bit en la palabra de bits de la columna Attributes de la tabla Control para establecer este atributo al crear el control.
RTLRO	0x00000000 0x00000020	El texto del control se muestra en orden de lectura de izquierda a derecha. El texto del control se muestra en orden de lectura de derecha a izquierda.
RightAligned	0x00000000 0x00000040	El texto del control está alineado a la izquierda. El texto del control está alineado a la derecha.
LeftScroll	0x00000000 0x00000080	La barra de desplazamiento se encuentra a la derecha del control. La barra de desplazamiento se encuentra a la izquierda del control.
BiDi	0x000000E0	Establezca este valor para una combinación de los atributos RTLRO, RightAligned y LeftScroll.
Sorted	0x00000000 0x00010000	Los elementos se muestran en orden alfabético. Los elementos se muestran en el orden que se especifica en la tabla ListView. Incluya este bit en la palabra de bits de la columna Attributes para mostrar los elementos en el orden que se especifica en la columna Order de la tabla ListView.
FixedSize	0x00000000 0x00100000	Estira la imagen del icono para ajustarse al control. Recorta o centra la imagen del icono en el control. Incluya este bit en la palabra de bits de la columna Attributes de la tabla Control.
IconSize	0x00000000 0x00200000 0x00400000 0x00600000	Carga la primera imagen. Carga la primera imagen de 16 x 16. Carga la primera imagen de 32 x 32. Carga la primera imagen de 48 x 48. Un archivo de icono puede contener imágenes de diferentes tamaños del mismo icono. Incluya el valor de la palabra bit adecuada en la columna Atributos de la tabla Control Si no se establecen estos bits, el instalador omite el atributo FixedSize y la imagen se estira para ajustarla al rectángulo de control. Si se establecen los bits IconSize y FixedSize, se centra una imagen si es más pequeña que el control y se reduce una imagen si es mayor que el control para que se ajusten.

 

Comentarios

Este control se puede crear a partir de la clase WC_LISTVIEW mediante la función CreateWindowEx. Tiene los estilos LVS_REPORT, LVS_NOCOLUMNHEADER, WS_VSCROLL, WS_HSCROLL, LVS_SHAREIMAGELISTS, LVS_SINGLESEL, LVS_SHOWSELALWAYS, WS_BORDER y WS_TABSTOP. Si el bit de estilo Sorted no está activado, el control también tiene el estilo LVS_SORTASCENDING.

Para la compatibilidad con lectores de pantalla, al crear un diálogo con un control ListView como primer control activo, debe hacer que el campo de texto que pertenece al campo de edición sea el primer control activo de la tabla Dialog. Puesto que el texto estático no puede centrarse, cuando se crea el diálogo, el campo de edición tendrá el foco inicialmente según lo previsto; aunque esto garantiza que los lectores de pantalla muestren la información correcta.