Padrões e interfaces de controle
Lista os padrões de controle de Automação da Interface do Usuário da Microsoft, 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 de Automação da Interface do Usuário Microsoft. Ela 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 da Interface do Usuário para implementá-las. A coluna Padrão de controle mostra o nome do padrão da perspectiva do cliente da Automação da Interface do Usuário, como um valor constante listado em Control Pattern Availability Property Identifiers. Da perspectiva do provedor da Automação da Interface do Usuário, cada um desses padrões é um nome de constante PatternInterface. A coluna Class provider interface mostra o nome da interface que os provedores implementam para fornecer esse padrão para um controle personalizado XAML.
Para saber mais sobre como implementar pares de automação personalizados que exponham padrões de controle e implementem as interfaces, consulte Pares de automação personalizados.
Ao implementar um padrão de controle, você também deverá consultar a documentação do provedor da Automação da Interface do Usuário, que explica algumas das expectativas que os clientes têm de um padrão de controle, independentemente de qual estrutura da IU é usada para implementá-lo. Algumas das informações listadas na documentação geral do provedor da Automação da Interface do Usuário influenciará a forma como você implementa seus pares e dá suporte correto a esse padrão. Consulte Implementando padrões de controle de Automação da Interface do Usuário, e visualize a página que documenta o padrão que você pretende implementar.
Padrão de controle | Interface do provedor de classe | Descrição |
---|---|---|
Anotação | IAnnotationProvider | Usado para expor as propriedades de uma anotação em um documento. |
Doca | IDockProvider | Usado para controles que podem ser encaixados em um contêiner. Por exemplo, barras de ferramentas ou paletas de ferramentas. |
Arrastar | IDragProvider | Usado para oferecer suporte aos controles arrastáveis ou controles com itens arrastáveis. |
DropTarget | IDropTargetProvider | Usado para oferecer suporte aos controles podem ser o destino para uma operação de arrastar e soltar. |
Expandcollapse | IExpandCollapseProvider | Usado para oferecer suporte aos controles que se expandem visualmente para exibir mais conteúdo e se recolhem para ocultar o conteúdo. |
Grid | IGridProvider | Usado para controles que dão suporte à funcionalidade de grade, como dimensionamento e transferência para uma célula especificada. Observe que Grade em si não implementa esse padrão porque ele fornece layout, mas não é um controle. |
GridItem | IGridItemProvider | Usado para controles que possuem células nas grades. |
Invoke | IInvokeProvider | Usado para controles que podem ser invocados, como um Botão. |
ItemContainer | IItemContainerProvider | Possibilita que os aplicativos localizem um elemento em um contêiner, como uma lista virtualizada. |
MultipleView | IMultipleViewProvider | Usado para controles que podem alternar entre várias representações do mesmo conjunto de informações, dados ou filhos. |
ObjectModel | IObjectModelProvider | Usado para expor um ponteiro para o modelo de objeto subjacente de um documento. |
RangeValue | IRangeValueProvider | Usado para controles que possuem um intervalo de valores que podem ser aplicados ao controle. Por exemplo, um controle giratório contendo anos poderia ter o intervalo de 1900 até ano atual, já outro contendo meses poderia ter o intervalo de 1 a 12. |
Rolar | IScrollProvider | Usado para controles que podem ser rolados. Por exemplo, um controle que tenha barras de rolagem que ficam ativas quando há mais informações que podem ser exibidas na área de visualização do controle. |
ScrollItem | IScrollItemProvider | Usado para controles que possuem itens individuais em uma lista de rolagem. Por exemplo, um controle de lista que possua itens individuais na lista de rolagem, como um controle de caixa de combinação. |
Seleção | ISelectionProvider | Usado para controles de contêiner de seleção. Por exemplo, ListBox e ComboBox. |
SelectionItem | ISelectionItemProvider | Usado para itens individuais nos controles do contêiner de seleção, como caixas de listagem e caixas de combinação. |
Planilha | ISpreadsheetProvider | Usado para expor o conteúdo de uma folha de cálculo ou de outro documento baseado em grade. |
SpreadsheetItem | ISpreadsheetItemProvider | Usado para expor as propriedades de uma célula em uma folha de cálculo ou outro documento baseado em grade. |
Estilos | IStylesProvider | Usado para descrever um elemento de interface do usuário que tem um estilo, cor de preenchimento, padrão de preenchimento ou forma específico. |
SynchronizedInput | ISynchronizedInputProvider | Permite que os aplicativos de cliente da Automação da Interface do Usuário redirecionem a entrada do mouse ou do teclado para um elemento da interface do usuário específico. |
Tabela | ITableProvider | Usado para controles que possuem uma grade e informações de cabeçalho. Por exemplo, um controle de calendário tabular. |
TableItem | ITableItemProvider | Usado para itens em uma tabela. |
Texto | ITextProvider | Usado para editar controles e documentos que exponham informações textuais. Consulte também ITextRangeProvider e ITextProvider2. |
TextChild | ITextChildProvider | Usado para acessar o antecessor mais próximo de um elemento que suporta o padrão de controle Text. |
TextEdit | Não há classe gerenciada disponível | Fornece acesso a um controle que modifica o texto, por exemplo, um controle que executa correção automática ou permite a composição de entrada através de um IME (Editor de Método de Entrada). |
TextRange | ITextRangeProvider | Fornece acesso a um conjunto de texto contínuo em um contêiner de texto que implementa ITextProvider. Consulte também ITextRangeProvider2. |
Alternar | IToggleProvider | Usado para controles onde é possível alternar o estado. Por exemplo, CheckBox e itens de menu que podem ser marcados. |
Transformar | ITransformProvider | Usado para controles que podem ser redimensionados, transferidos e girados. O padrão de controle de transformação costuma ser usado em aplicativos de desenho, design, formulários e editores gráficos. |
Valor | IValueProvider | Possibilita que os clientes obtenham ou definam um valor nos controles que não dão suporte a um intervalo de valores. |
VirtualizedItem | IVirtualizedItemProvider | Expõe itens nos contêineres que são virtualizados e precisam estar totalmente acessíveis como elementos de automação da IU. |
Window | IWindowProvider | Expõe informações específicas de janelas, um conceito fundamental para o sistema operacional Microsoft Windows. Exemplos de controles que são janelas filho e caixas de diálogo. |
Observação
Você não encontrará necessariamente implementações de todos esses padrões em controles XAML existentes. Alguns dos padrões têm interfaces exclusivamente para oferecer suporte à paridade com a definição de padrões da estrutura de Automação da IU geral e para oferecer suporte a cenários de mesmo nível de automação que exigirão uma implementação puramente personalizada para oferecer suporte a esse padrão.
Observação
Os aplicativos da Store do Windows Phone não dão suporte a todos os padrões de controle de Automação da Interface do Usuário listados aqui. Annotation, Dock, Drag, DropTarget, ObjectModel são alguns dos padrões sem suporte.
Tópicos relacionados
Windows developer
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de