ListView Control
Control ListView que muestra una sola columna de valores con un icono junto a cada elemento. Permite al usuario seleccionar un único valor de cadena o entero para una propiedad de una lista predeterminada. Los valores posibles se leen de la tabla ListView. Puede asociar el control a un valor entero o de cadena escribiendo el nombre de la propiedad en la columna Propiedad de la tabla control de .
El control ListView nunca muestra el contenido del campo Texto de la tabla de 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 utilidades de revisión de pantalla. Para establecer el estilo de fuente y fuente de una cadena de texto, prefijo la cadena de caracteres mostrados con {\style} o {&estilo}. Donde style es un identificador que aparece en la columna TextStyle de la tabla TextStyle. Si ninguno de estos elementos está presente, pero la propiedad DefaultUIFont se define como un estilo de texto válido, se usará esa fuente. La información siguiente se lee mediante la revisión de pantalla de utilidades como descripción del control. Consulte accesibilidad.
Atributos de control
Puede usar los siguientes atributos con este control. Para cambiar el valor de un atributo mediante un evento, suscríbase el control a un ControlEvent en la tabla eventMapping de y enumere el identificador del atributo en la columna Atributo. Escriba el identificador de ControlEvent en la columna Evento.
| 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 Propiedad de la tabla control de . | |
| posición | Posición del control en el cuadro de diálogo. Escriba 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 de . Use unidades del instalador para la longitud y la distancia. |
|
| PropertyName de | 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 Propiedad de la tabla control de . | |
| PropertyValue | Valor actual de la propiedad mostrada o modificada por este control. Si no se establece el bit de atributo indirecto, este es el valor de PropertyName. Si se establece el bit de atributo indirecto, este es el valor de IndirectPropertyName. Si el atributo cambia, el control refleja el nuevo valor. | |
| text | Para mostrar texto en lectores de pantalla, escriba el texto en la columna Texto de la tabla control de . Consulte accesibilidad. | |
| visible | 0x00000000 0x00000001 |
Control oculto. Control visible. Incluya este bit en la palabra bit de la columna Atributos de la tabla control de para que el control sea visible o oculto tras su creación. También puede ocultar o mostrar un control mediante la tabla ControlCondition de . |
| habilitado para | 0x00000000 0x00000002 |
Controlar en un estado deshabilitado. Controlar en un estado habilitado. Incluya este bit en la palabra bit de la columna Atributos del Control para habilitar el control sobre la creación. También puede habilitar o deshabilitar un control mediante la tabla controlCondition de . |
| hundido | 0x00000000 0x00000004 |
Muestra el estilo visual predeterminado. Muestra el control con un aspecto 3D, hundido. Incluya estos bits en la palabra bit de la columna Atributos de la tabla control de . |
| indirecto | 0x00000000 0x00000008 |
El control muestra o cambia el valor de la propiedad en la columna Propiedad de la tabla control de . El control muestra o cambia el valor de la propiedad que tiene el identificador enumerado en la columna Propiedad de la tabla Control. Determina si la propiedad asociada a este control se hace referencia indirectamente. |
| 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 bit de la columna Atributos de la tabla control de para establecer este atributo al crear el control. |
| RTLRO de | 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 se alinea a la izquierda. El texto del control está alineado a la derecha. |
| LeftScroll | 0x00000000 0x00000080 |
La barra de desplazamiento se encuentra en el lado derecho del control. La barra de desplazamiento se encuentra en el lado izquierdo del control. |
| biDi | 0x000000E0 | Establezca este valor para una combinación de los atributos RTLRO, RightAlignedy LeftScroll. |
| ordenados | 0x00000000 0x00010000 |
Elementos mostrados en orden alfabético. Los elementos mostrados en orden especificados en la tabla ListView. Incluya este bit en la palabra bit de la columna Atributos para mostrar los elementos en el orden especificado por la columna Order de la tabla ListView. |
| fixedSize | 0x00000000 0x00100000 |
Amplía la imagen de icono para ajustarse al control. Recorta o centra la imagen de icono en el control . Incluya este bit en la palabra bit de la columna Atributos de la tabla control de . |
| icono de Icono de tamaño | 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 tamaño diferentes del mismo icono. Incluya el valor de la palabra de bits adecuada en la columna Atributos de la tabla control de Si no se establecen estos bits, el instalador omite el atributo FixedSize y la imagen se extiende para ajustarse al rectángulo de control. Si se establecen los bits IconSize y fixedSize, se establece una imagen más pequeña que el control y una imagen es mayor que el control que se reduce para ajustarse. |
Observaciones
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_BORDERy WS_TABSTOP. Si el bit de estilo ordenado no está activado, el control también tiene el estilo LVS_SORTASCENDING.
Para la compatibilidad con los lectores de pantalla, al crear un cuadro de diálogo con un control ListView como primer control activo, debe hacer que el campo de texto pertenezca al campo de edición el primer control activo en la tabla Cuadro de diálogo. Dado que el texto estático no puede centrarse, cuando se crea el cuadro de diálogo, el campo de edición tendrá el foco inicialmente según lo previsto, pero al hacerlo se garantiza que los lectores de pantalla muestren la información correcta.