Patrón de control Styles

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

El patrón de control Styles 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 cadena determinada como título de un documento o un determinado objeto de diagrama de flujo como un rombo 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.

En este tema se incluyen las siguientes secciones.

• Directrices y convenciones de implementación
• Miembros necesarios para IStylesProvider
• Temas relacionados

Directrices y convenciones de implementación

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

• El archivo de encabezado UIAutomationClient.h define un conjunto de valores constantes con nombre que se usan para identificar varios estilos comunes. Para obtener más información, vea 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 Microsoft Automatización de la interfaz de usuario proporciona un nombre predeterminado, pero puede implementarlo si necesita invalidar el nombre predeterminado.
• Las demás 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 para el 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 de texto StyleName para permitir que los clientes detecten el nombre del estilo.
  • Un intervalo de texto que tenga varios estilos, como encabezado y texto normal, debe devolver la propiedad special 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 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 . Se trata básicamente de 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 requeridos	Tipo de miembro	Notas
ExtendedProperties	Propiedad	None
FillColor	Propiedad	None
FillPatternColor	Propiedad	None
FillPatternStyle	Propiedad	None
Forma	Propiedad	None
StyleId	Propiedad	None
NombreEstilo	Propiedad	None

 

Este patrón de control no tiene métodos o propiedades asociados.

Temas relacionados

Tipos de control y sus patrones de control admitidos

Información general acerca de los patrones de control de UI Automation

Información general sobre el árbol de la UI Automation