Compartir a través de

Patrón de control Styles

  • Artículo

Describe instrucciones y convenciones para implementar IStylesProvider, incluida información sobre las propiedades y los métodos. El Estilos patrón de control se usa para describir un elemento de interfaz de usuario que tiene un estilo específico, color de relleno, patrón de relleno o forma.

El Estilos patrón de control es especialmente útil para describir elementos de un documento, que suelen tener estos estilos. Los estilos suelen llevar información útil para los clientes con discapacidades; Por ejemplo, un estilo puede describir una determinada cadena como título de un documento o un determinado objeto de diagrama de flujo como un diamante o un círculo. Para obtener ejemplos de controles que implementan este patrón de control, vea tipos de control y sus patrones de control admitidos.

Este tema contiene las secciones siguientes.

Directrices y convenciones de implementación

Al implementar el patrón de control estilos de , tenga en cuenta las siguientes directrices y convenciones:

  • El archivo de encabezado UIAutomationClient.h define un conjunto de valores constantes con nombre usados para identificar varios estilos comunes. Para obtener más información, consulte identificadores de estilo.
  • Si usa StyleId_Custom, debe implementar la propiedad IStylesProvider::StyleName para permitir que los clientes detecten el nombre del estilo. No es necesario implementar la propiedad StyleName para un estilo estándar porque Automatización de la interfaz de usuario de Microsoft proporciona un nombre predeterminado, pero puede implementarlo si necesita invalidar el nombre predeterminado.
  • Las otras propiedades del patrón Styles son opcionales; el proveedor puede devolver UIA_E_NOTSUPPORTED para una propiedad que no se admite.
  • Los estilos de un intervalo de texto se pueden representar mediante los siguientes atributos de texto:
    • Al responder a una solicitud del atributo de texto StyleId, el intervalo de texto debe devolver uno de los identificadores de estilo descritos en Identificadores de estilo.
    • Si se usa StyleId_Custom, el intervalo de texto debe devolver un valor de cadena para el atributo styleNamepara permitir que los clientes detecten el nombre del estilo.
    • Un intervalo de texto que tenga varios estilos, como el encabezado y el texto normal, debe devolver las propiedades especiales de automatización de la interfaz de usuario ReservedMixedAttributeValue para las propiedades StyleId y StyleName. Un cliente que recibe esta respuesta puede subdividir el intervalo de texto para buscar dónde comienzan y terminan los estilos.
  • Las aplicaciones pueden usar una amplia variedad de estilos para describir objetos, pero la automatización de la interfaz de usuario representa solo las más comunes. Para representar atributos de estilo adicionales, como el color del borde, un proveedor puede devolver una lista de atributos adicionales en la propiedad ExtendedProperties . Esto es básicamente un contenedor de propiedades con un conjunto de propiedades extendidas, como "BorderColor=0xFF0000; BorderStyle=dotted". Los valores de las propiedades extendidas pueden ser específicos de la aplicación.

Miembros necesarios para IStylesProvider

Las siguientes propiedades son necesarias para implementar la interfaz IStylesProvider.

Miembros necesarios Tipo de miembro Notas
extendedProperties Propiedad Ninguno
FillColor Propiedad Ninguno
FillPatternColor Propiedad Ninguno
FillPatternStyle Propiedad Ninguno
de formas Propiedad Ninguno
StyleId Propiedad Ninguno
styleName Propiedad Ninguno

 

Este patrón de control no tiene métodos ni eventos asociados.

tipos de control y sus patrones de control admitidos

Introducción a los patrones de control de automatización de la interfaz de usuario de

Información general del árbol de automatización de la interfaz de usuario de