Compartilhar via


Implementando o padrão de controle MultipleView de interface de usuário

Observação

Esta documentação destina-se a desenvolvedores de .NET Framework que querem usar as classes da 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 do Usuário, confira API de Automação do Windows: Automação da Interface do Usuário.

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

O painel de controle MultipleViewPattern é usado para dar suporte aos controles que fornecem e pode alternar entre várias representações do mesmo conjunto de informações ou controles filho.

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 Player de Mídia do Microsoft Windows. As exibições com suporte são determinadas pelo desenvolvedor de controle e são específicas para cada controle.

Diretrizes e convenções de implementaçã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 Windows Explorer contém um controle Lista para o conteúdo da pasta atual, enquanto a exibição do controle é gerenciada a partir do aplicativo Windows Explorer.

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

  • A coleção de exibições deve ser idêntica entre as instâncias.

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

Membros necessários para IMultipleViewProvider

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

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

Não há eventos associados a esse padrão de controle.

Exceções

O provedor deve gerar as exceções a seguir.

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

Confira também