Compartilhar via

Padrões e interfaces de controle

Lista os padrões de controle Microsoft Automação da Interface do Usuário, as classes que os clientes usam para acessá-los e as interfaces que os provedores usam para implementá-los.

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

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 geral do provedor de Automação da Interface do Usuário influenciarão a forma como você implementa seus pares e dá suporte corretamente a esse padrão. Consulte Implementing Automação da Interface do Usuário Control Patterns e exiba a página que documenta o padrão que você pretende implementar.

Padrão de controle Interface do provedor WinUI Equivalente herdado de 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 aplicativos cliente de Automação da Interface do Usuário direcionem a entrada do mouse ou do teclado para um elemento específico da interface do usuário.
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 Automação da Interface do Usuário.
Janela Iwindowprovider Iwindowprovider Expõe informações específicas ao 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. Algumas interfaces de padrão existem apenas para manter a compatibilidade 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 peers de automação que exigem uma implementação totalmente personalizada.

  • Last updated on