Compartir a través de


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

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:
  • 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.

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