Implementing the UI Automation Window Control Pattern

Artigo
08/25/2010

Este tópico apresenta diretrizes e convenções para a implementação IWindowProviderIncluindo informações sobre WindowPattern propriedades, métodos e eventos.Links para referências adicionais são listadas ao final do tópico.

O WindowPattern Controle padrão é usada para oferecer suporte aos controles que fornecem funcionalidade fundamental janela-com base em um tradicional .Exemplos de controles que devem implementar esse controle padrão Incluir janelas de aplicativos de nível superior, dividir janelas filho, redimensionáveis Painel controles, Caixas de diálogo restrita e janelas de Ajuda de Balão.

Este tópico contém as seguintes seções.

Orientações e Convenções de Implementação
Membros necessários para IWindowProvider
Exceções
Tópicos relacionados

Orientações e Convenções de Implementação

Ao implementar o padrão de controles Window, observe as seguintes diretrizes e convenções:

Para oferecer suporte a capacidade para modificar o tamanho da janela e tela Posição usando automação interface do usuário, um controle deve implementar ITransformProvider Junto com IWindowProvider.
Controles que contêm barras de título e barra de título elementos que permitem o controle para ser movido redimensionado maximizado, minimizado, ou Fechadas são geralmente necessários para implementar IWindowProvider.
Controles como dica de ferramenta pop-ups e caixa de combinação ou menu Soltar - field não normalmente implementa IWindowProvider.
Janelas de ajuda em balão são diferenciadas de pop-ups básicos de tooltip pelo fornecimento de um botão Fechar parecido com o presente em janelas.
O modo de tela cheia não é suportado por IWindowProvider pois é um recurso específico de um aplicativo e não é um comportamento típico de uma janela.

Membros necessários para IWindowProvider

As propriedades, métodos e eventos a seguir são necessários para a interface IWindowProvider.

Membro necessário	Tipo do membro	Anotações
InteractionState()	Propriedade	Nenhum
IsModal	Propriedade	Nenhum
IsTopmost	Propriedade	Nenhum
Maximizable	Propriedade	Nenhum
Minimizable	Propriedade	Nenhum
VisualState	Propriedade	Nenhum
Close	Método	Nenhum
SetVisualEstado(WindowVisualEstado)	Método	Nenhum
WaitForInputOcioso(Int32)	Método	Nenhum
WindowClosedEvent	Evento	Nenhum
WindowOpenedEvent	Evento	Nenhum
WindowInteractionState	Evento	Não É garantida para ser ReadyForUserInteraction

Exceções

Provedores precisam lançar as seguintes exceções.

Tipo de exceção	Condição
InvalidOperationException	SetVisualEstado(WindowVisualEstado) Quando um controle não tiver suporte para um comportamento solicitado.
ArgumentOutOfRangeException	WaitForInputOcioso(Int32) Quando o parâmetro não for um número válido.

InvalidOperationException

SetVisualEstado(WindowVisualEstado)