Implementando o padrão de controle MultipleView de automação da interface do usuário

Observação

Esta documentação destina-se a desenvolvedores do .NET Framework que desejam usar as classes de automação da interface do usuário gerenciadas definidas no namespace System.Windows.Automation. Para obter as informações mais recentes sobre a automação da interface de utilizador, consulte API de automação do Windows: Automação da Interface de Utilizador.

Este tópico apresenta diretrizes e convenções para implementação IMultipleViewProvider, incluindo informações sobre eventos e propriedades. Links para referências adicionais estão listados no final do tópico.

O MultipleViewPattern padrão de controle é utilizado para suportar controlos que oferecem a capacidade de alternar entre múltiplas representações do mesmo conjunto de informações ou controlos secundários.

Exemplos de controles que podem apresentar vários modos de exibição incluem o modo de exibição de lista (que pode mostrar seu conteúdo como miniaturas, blocos, ícones ou detalhes), gráficos do Microsoft Excel (pizza, linha, barra, valor de célula com uma fórmula), documentos do Microsoft Word (normal, layout da Web, layout de impressão, layout de leitura, estrutura de tópicos), calendário do Microsoft Outlook (ano, mês, semana, dia) e capas do Microsoft Windows Media Player. As exibições suportadas são determinadas pelo desenvolvedor do controle e são específicas para cada controle.

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

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

• IMultipleViewProvider também deve ser implementado em um contêiner que gerencia o modo de exibição atual se ele for diferente de um controle que fornece o modo de exibição atual. Por exemplo, o Explorador do Windows contém um controlo de lista para o conteúdo da pasta atual, enquanto a visualização desse controlo é gerida pela aplicação Explorador do Windows.

• Um controle que é capaz de classificar seu conteúdo não é considerado para suportar várias visualizações.

• A coleção de visualizações deve ser idêntica em todas as instâncias.

• Os nomes de exibição devem ser adequados para uso em Text to Speech, Braille e outros aplicativos legíveis por humanos.

Membros necessários para IMultipleViewProvider

As seguintes propriedades e métodos são necessários para implementar IMultipleViewProvider.

Membros obrigatórios	Tipo de membro	Observações
CurrentView	Propriedade	Nenhum
GetSupportedViews	Método	Nenhum
GetViewName	Método	Nenhum
SetCurrentView	Método	Nenhum

Não existem eventos associados a este padrão de controlo.

Exceções

O provedor deve lançar as seguintes exceções.

Tipo de exceção	Condição
ArgumentException	Quando SetCurrentView ou GetViewName é chamado com um parâmetro que não é um membro da coleção de visualizações suportadas.

Ver também

• Visão geral dos padrões de controle de automação da interface do usuário
• Suportar Padrões de Controle em um Provedor de Automação de Interface do Usuário
• Padrões de Controle de Automação da Interface do Usuário para Clientes
• Visão geral da árvore de automação da interface do usuário
• Use o armazenamento em cache na automação da interface do utilizador