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.