Compartilhar via


Padrão de controle estilos

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

O padrão de controle Styles é especialmente útil para descrever elementos em um documento, que frequentemente têm esses estilos. Os estilos normalmente carregam informações úteis para clientes com deficiências; 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 losango 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 com suporte.

Este tópico inclui as seções a seguir.

Diretrizes e convenções de implementaçã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. Você não precisa implementar a propriedade StyleName para um estilo padrão porque o Microsoft Automação da Interface do Usuário fornece um nome padrão, mas você pode implementá-la se precisar substituir o nome padrão.
  • As outras propriedades no padrão Styles são opcionais; o provedor pode retornar UIA_E_NOTSUPPORTED para uma propriedade sem suporte.
  • 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 Identificadores de Estilo.
    • Se StyleId_Custom for usado, o intervalo de texto deverá retornar um valor de cadeia de caracteres para o atributo de texto StyleName para permitir que os clientes descubram o nome do estilo.
    • Um intervalo de texto que tem vários estilos, como título e texto normal, deve retornar a propriedade special Automação da Interface do Usuário ReservedMixedAttributeValue para as propriedades StyleId e StyleName. Um cliente que recebe essa resposta pode subdividir o intervalo de texto para descobrir onde os estilos começam e terminam.
  • Os aplicativos podem usar uma ampla variedade de estilos para descrever objetos, mas Automação da Interface do Usuário representa apenas os mais comuns. Para representar atributos de estilo adicionais, como a cor da borda, um provedor pode retornar uma lista de atributos adicionais na propriedade ExtendedProperties . Esse é basicamente um recipiente de propriedades com um conjunto de propriedades estendidas, como "BorderColor=0xFF0000; BorderStyle=dotted". 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 a interface IStylesProvider .

Membros necessários Tipo de membro Observações
ExtendedProperties Propriedade Nenhum
Fillcolor Propriedade Nenhum
FillPatternColor Propriedade Nenhum
FillPatternStyle Propriedade Nenhum
Forma Propriedade Nenhum
StyleId Propriedade Nenhum
StyleName Propriedade Nenhum

 

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

Tipos de controle e seus padrões de controle com suporte

Visão Geral de Padrões de Controle de Automação de Interface de Usuário

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