Compartilhar via

Padrões e interfaces de controle

Lista os padrões de controle do Microsoft UI Automation, as classes que os clientes usam para acessá-los e os provedores de interfaces usam para implementá-los.

A tabela neste tópico descreve os padrões de controle da Automação da Interface do Usuário da Microsoft. A tabela também lista as classes usadas pelos clientes de Automação da Interface do Usuário para acessar os padrões de controle e as interfaces usadas pelos provedores de Automação de Interface do Usuário para implementá-los. A coluna padrão de controle mostra o nome do padrão da perspectiva do cliente da UI Automation, como um valor constante que está listado em Identificadores de Propriedade de Disponibilidade de Padrão de Controle. Da perspectiva do provedor de Automação da Interface do Usuário, cada um desses padrões é um nome constante PatternInterface . A coluna de interface do provedor de classe mostra o nome da interface que os provedores implementam para fornecer esse padrão para um controle XAML personalizado.

Observação

Para aplicativos WinUI criados com o SDK do Aplicativo do Windows, use as interfaces em Microsoft.UI.Xaml.Automation.Provider. Para aplicativos UWP, use Windows.UI.Xaml.Automation.Provider.

Para obter mais informações sobre como implementar pares de automação personalizados que expõem padrões de controle e implementam as interfaces, consulte Pares de automação personalizados.

Ao implementar um padrão de controle, você também deve consultar a documentação do provedor de Automação da Interface do Usuário que explica algumas das expectativas que os clientes terão de um padrão de controle, independentemente de qual estrutura de interface do usuário seja usada para implementá-la. Algumas das informações listadas na documentação do provedor geral de UI Automation influenciarão como você implementa seus equivalentes e apoia corretamente esse padrão. Consulte Implementando Padrões de Controle de Automação de Interface do Usuário e veja a página que documenta o padrão que você pretende implementar.

Padrão de controle Interface do provedor WinUI Interface do provedor UWP Descrição
Annotation IAnnotationProvider IAnnotationProvider Usado para expor as propriedades de uma anotação em um documento.
Dock Idockprovider Idockprovider Usado para controles que podem ser encaixados em um contêiner de ancoragem. Por exemplo, barras de ferramentas ou paletas de ferramentas.
Drag IDragProvider IDragProvider Usado para dar suporte a controles arrastáveis ou controles com itens arrastáveis.
DropTarget IDropTargetProvider IDropTargetProvider Usado para dar suporte a controles que podem ser o destino de uma operação de arrastar e soltar.
Expandcollapse IExpandCollapseProvider IExpandCollapseProvider Usado para dar suporte a controles que se expandem visualmente para exibir mais conteúdo e recolher para ocultar o conteúdo.
Grade Igridprovider Igridprovider Usado para controles que suportam funcionalidades de tabela, como o dimensionamento e a movimentação para uma célula especificada. Observe que o próprio Grid não implementa esse padrão porque fornece layout, mas não é um controle.
GridItem Igriditemprovider Igriditemprovider Usado em controles que possuem células dentro de grades.
Invoke IInvokeProvider IInvokeProvider Usado para controles que podem ser invocados, como um Botão.
Itemcontainer IItemContainerProvider IItemContainerProvider Permite que os aplicativos encontrem um elemento em um contêiner, como uma lista virtualizada.
MultipleView IMultipleViewProvider IMultipleViewProvider Usado para controles que podem alternar entre várias representações do mesmo conjunto de informações, dados ou filhos.
Objectmodel IObjectModelProvider IObjectModelProvider Usado para expor um ponteiro para o modelo de objeto subjacente de um documento.
Rangevalue Irangevalueprovider Irangevalueprovider Usado para controles que têm um intervalo de valores que podem ser aplicados ao controle. Por exemplo, um controle spinner que contém anos pode ter um intervalo de 1900 até o ano atual, enquanto outro controle spinner que apresenta meses teria um intervalo de 1 a 12.
Scroll IScrollProvider IScrollProvider Usado para controles roláveis. Por exemplo, um controle que tem barras de rolagem que estão ativas quando há mais informações do que podem ser exibidas na área visível do controle.
ScrollItem IScrollItemProvider IScrollItemProvider Usado para controles que têm itens individuais em uma lista que rola. Por exemplo, um controle de lista que tem itens individuais na lista de rolagem, como um controle de caixa de combinação.
Seleção Iselectionprovider Iselectionprovider Usado para controles de seleção de contêiner. Por exemplo, ListBox e ComboBox.
Selectionitem ISelectionItemProvider ISelectionItemProvider Usado para itens individuais em controles de contêiner de seleção, como caixas de lista e caixas de combinação.
Planilha ISpreadsheetProvider ISpreadsheetProvider Usado para expor o conteúdo de uma planilha ou outro documento baseado em grade.
SpreadsheetItem ISpreadsheetItemProvider ISpreadsheetItemProvider Usado para expor as propriedades de uma célula em uma planilha ou em outro documento baseado em grade.
Estilos IStylesProvider IStylesProvider 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.
SynchronizedInput ISynchronizedInputProvider ISynchronizedInputProvider Permite que os aplicativos cliente da Automação da Interface do Usuário direcionem a entrada do mouse ou do teclado para um elemento de interface do usuário específico.
Tabela Itableprovider Itableprovider Usado para controles que têm uma grade, bem como informações de cabeçalho. Por exemplo, um controle de calendário tabular.
TableItem ITableItemProvider ITableItemProvider Usado para itens em uma tabela.
Texto Itextprovider Itextprovider Usado para editar controles e documentos que expõem informações textuais. Consulte também ITextRangeProvider e ITextProvider2.
TextChild ITextChildProvider ITextChildProvider Usado para acessar o ancestral mais próximo de um elemento que dá suporte ao padrão de controle Text.
Textedit Nenhuma classe gerenciada disponível Nenhuma classe gerenciada disponível Fornece acesso a um controle que modifica o texto, por exemplo, um controle que executa a correção automática ou habilita a composição de entrada por meio de um IME (Editor de Método de Entrada).
Intervalo de Texto ITextRangeProvider ITextRangeProvider Fornece acesso a um intervalo de texto contínuo em um contêiner de texto que implementa ITextProvider. Consulte também ITextRangeProvider2.
Toggle Itoggleprovider Itoggleprovider Usado para controles em que o estado pode ser alternado. Por exemplo, CheckBox e itens de menu que podem ser verificados.
Transform Itransformprovider Itransformprovider Usado para controles que podem ser redimensionados, movidos e girados. Os usos típicos para o padrão de controle Transform estão em ferramentas de design, formulários, editores gráficos e aplicativos de desenho.
Valor Ivalueprovider Ivalueprovider Permite que os clientes obtenham ou definam um valor em controles que não dão suporte a um intervalo de valores.
VirtualizedItem IVirtualizedItemProvider IVirtualizedItemProvider Expõe itens dentro de contêineres que são virtualizados e precisam ser totalmente acessíveis como elementos de Automação da Interface do Usuário.
Janela Iwindowprovider Iwindowprovider Expõe informações específicas do Windows, um conceito fundamental para o sistema operacional Microsoft Windows. Exemplos de controles que são janelas incluem janelas filhas e caixas de diálogo.

Observação

Nem todos esses padrões são implementados por controles XAML existentes. Existem algumas interfaces de padrão apenas para manter a paridade com as definições de padrão da estrutura geral de Automação da Interface do Usuário e para dar suporte a cenários de par de automação que exigem uma implementação totalmente personalizada.

  • Last updated on