Partilhar via


Padrão de controle de janela

Descreve diretrizes e convenções para implementar IWindowProvider, incluindo informações sobre propriedades, métodos e eventos. O padrão de controle Window suporta controles que fornecem funcionalidade fundamental baseada em janela dentro de uma GUI tradicional.

Exemplos de controles que devem implementar esse padrão de controle incluem janelas de aplicativos de nível superior, janelas filhas de interface de vários documentos (MDI), controles de painel dividido redimensionáveis, caixas de diálogo modais e janelas de ajuda de balão. Para obter exemplos de controles que implementam esse padrão de controle, consulte Control Pattern Mapping for UI Automation Clients.

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

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

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

  • Para suportar a capacidade de modificar o tamanho da janela e a posição da tela usando a automação da interface do usuário da Microsoft, um controle deve implementar ITransformProvider além de IWindowProvider.
  • Os controles que contêm barras de título e elementos da barra de título que permitem que o controle seja movido, redimensionado, maximizado, minimizado ou fechado normalmente são necessários para implementar IWindowProvider.
  • Controles como pop-ups de dica de ferramenta e menus suspensos de caixa de combinação ou menu normalmente não implementam IWindowProvider.
  • As janelas de ajuda em balão são diferenciadas dos pop-ups básicos de dicas de ferramentas pelo fornecimento de um botão Fechar semelhante a uma janela.
  • O modo de tela cheia não é suportado peloIWindowProviderpois é específico de um recurso para um aplicativo e não é um comportamento típico de janela.

Membros necessários para IWindowProvider

As seguintes propriedades, métodos e eventos são necessários para implementar o interface de IWindowProvider.

Membros obrigatórios Tipo de membro Observações
WindowInteractionState Propriedade Não é garantido que seja WindowInteractionState_ReadyForUserInteraction
IsModal Propriedade Nenhum
IsTopmost Propriedade Nenhum
CanMaximize Propriedade Nenhum
CanMinimize Propriedade Nenhum
WindowVisualState Propriedade Nenhum
Fechar Método Nenhum
SetVisualState Método Nenhum
WaitForInputIdle Método Nenhum
UIA_Window_WindowClosedEventId Evento Nenhum
UIA_Window_WindowOpenedEventId Evento Nenhum

 

Conceptual

Visão geral dos padrões de controle de automação da interface do do usuário

Mapeamento de padrões de controle para clientes de automação da interface do usuário

Visão geral da árvore de automação da interface do usuário