Patrón de control Styles

Describe las directrices y convenciones para implementar IStylesProvider, incluida la información sobre las propiedades y los 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 los 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.

En este tema se incluyen las siguientes secciones.

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 a través de 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 de estilo.
    • Un intervalo de texto que tiene varios estilos, como el encabezado y el 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 los 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.

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