Padrão de controle de estilos

Descreve diretrizes e convenções para implementar IStylesProvider, incluindo informações sobre propriedades e métodos. O padrão de controle Estilos de é usado para descrever um elemento da interface do usuário que tem um estilo, cor de preenchimento, padrão de preenchimento ou forma específicos.

O padrão de controle Estilos é especialmente útil para descrever elementos em um documento, que frequentemente têm esses estilos. Os estilos normalmente carregam informações que são úteis para clientes com deficiência; Por exemplo, um estilo pode descrever uma determinada cadeia de caracteres como o título de um documento ou um determinado objeto de fluxograma como um diamante ou um círculo. Para obter exemplos de controles que implementam esse padrão de controle, consulte tipos de controle e seus padrões de controle suportados.

Este tópico contém as seguintes seções.

• Diretrizes de Implementação e Convenções
• Membros necessários para IStylesProvider
• Tópicos relacionados

Orientações e convenções de aplicação

Ao implementar o padrão de controle Estilos, observe as seguintes diretrizes e convenções:

• O arquivo de cabeçalho UIAutomationClient.h define um conjunto de valores constantes nomeados usados para identificar vários estilos comuns. Para obter mais informações, consulte Identificadores de estilo.
• Se você usar StyleId_Custom, deverá implementar a propriedade IStylesProvider::StyleName para permitir que os clientes descubram o nome do estilo. Não é necessário implementar a propriedade StyleName para um estilo padrão porque a Automação da Interface do Usuário da Microsoft fornece um nome padrão, mas você pode implementá-lo se precisar substituir o nome padrão.
• As outras propriedades no padrão Estilos são opcionais; O provedor pode retornar UIA_E_NOTSUPPORTED para uma propriedade que não é suportada.
• Os estilos em um intervalo de texto podem ser representados por meio dos seguintes atributos de texto:
  • Ao responder a uma solicitação para o atributo de texto StyleId, o intervalo de texto deve retornar um dos identificadores de estilo descritos em Style Identifiers.
  • Se StyleId_Custom for usado, o intervalo de texto deverá retornar um valor de cadeia de caracteres para o atributo StyleName text para permitir que os clientes descubram o nome do estilo.
  • Um intervalo de texto que tenha vários estilos, como título e texto normal, deve retornar a propriedade especialAutomação da Interface do UsuárioReservedMixedAttributeValue para as propriedades StyleId e StyleName. Um cliente que recebe essa resposta pode subdividir o intervalo de texto para encontrar onde os estilos começam e terminam.
• Os aplicativos podem usar uma grande variedade de estilos para descrever objetos, mas a Automação da Interface do Usuário representa apenas os mais comuns. Para representar atributos de estilo adicionais, como cor da borda, um provedor pode retornar uma lista de atributos adicionais na propriedadeExtendedProperties. Este é basicamente um saco de propriedades com um conjunto de propriedades estendidas, como "BorderColor=0xFF0000; BorderStyle=pontilhado". Os valores das propriedades estendidas podem ser específicos do aplicativo.

Membros necessários para IStylesProvider

As propriedades a seguir são necessárias para implementar o IStylesProvider interface.

Esse padrão de controle não tem métodos ou eventos associados.

Tópicos relacionados

tipos de controle e seus padrões de controle suportados

Visão geral dos padrões de controle de automação da interface do do usuário

Visão geral da árvore de automação da interface do usuário