Styles (patrón de control)

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

El patrón de control de estilos es especialmente útil para describir los elementos de un documento, que suelen tener tales 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 objeto de diagrama de flujo determinado 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

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 utilizan para identificar varios estilos comunes. Para obtener más información, vea identificadores de estilo.
  • Si usa el StyleId _ personalizado, 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 la automatización de la interfaz de usuario de Microsoft proporciona un nombre predeterminado, pero se puede implementar si es necesario reemplazar el nombre predeterminado.
  • Las demás propiedades del patrón de estilos 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 de estilo.
    • Un intervalo de texto que tiene varios estilos, como el encabezado y el texto normal, debe devolver la propiedad ReservedMixedAttributeValue de automatización de la interfaz de usuario especial para las propiedades StyleId y StyleName . Un cliente que recibe esta respuesta puede subdividir el intervalo de texto para encontrar 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 solo representa 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 = punteado ". Los valores de las propiedades extendidas pueden ser específicos de la aplicación.

Miembros requeridos para IStylesProvider

Las siguientes propiedades son necesarias para implementar la interfaz IStylesProvider .

Miembros requeridos Tipo de miembro Notas
ExtendedProperties Propiedad None
Relleno 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