Partilhar via


Implementing the UI Automation Dock Control Pattern

Este tópico apresenta diretrizes e convenções para a implementação IDockProvedorIncluindo informações sobre propriedades.Links para referências adicionais são listadas ao final do tópico.

O DockPattern Padrão de controle é usado para expor as plataforma propriedades de um controle em um Contêiner de encaixe.A docking container is a control that allows you to arrange child elements horizontally and vertically, relative to each other.Para obter exemplos de controles que implementam esse padrão de controle, consulte Mapeamento de Padrão de Controles para Clientes de Automação de IU.

Docking Example from Visual Studio Where "Class View" Window Is DockPosition.Right and "Error List" Window Is DockPosition.Bottom

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

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

When implementing the Dock control pattern, note the following guidelines and conventions:

  • IDockProvedor não expõe as propriedades do recipiente de encaixe ou propriedades de controles que são encaixados adjacente o controle atual no recipiente de encaixe.

  • Controles são encaixados Relativo umas às outras com base em sua atual ordem-z; a maior seus ordem-z posicionamento, afaste a que eles são colocados da borda especificada do recipiente de encaixe.

  • If the docking container is resized, any docked controls within the container will be repositioned flush to the same edge to which they were originally docked.Os controles encaixados serão também Redimensionar para preencher qualquer espaço no recipiente de acordo com ao comportamento de encaixe do seu DockPosition.Por exemplo, se [F:System.Windows.Automation.DockPosição.Top] for especificado, à esquerda e Direito lados do controle se expandirá para preencher qualquer espaço disponível.Se Fill for especificado, todos os quatro lados do controle se expandirá para preencher qualquer espaço disponível.

  • On a multi-monitor system, controls should dock to the left or right side of the current monitor.If that is not possible, they should dock to the left side of the leftmost monitor or the right side of the rightmost monitor.

Required Members for IDockProvider

The following properties and methods are required for implementing the IDockProvider interface.

Membros Requeridos

Tipo do membro

Anotações

DockPosition()

Propriedade

Nenhum

SetDockPosition

Método

Nenhum

Esse padrão de controle não possui eventos associados.

Exceções

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

Tipo de exceção

Condição

InvalidOperationException

SetDockPosition

  • When a control is not able to execute the requested dock style.

Consulte também

Tarefas

Support Control Patterns in a UI Automation Provider

Use Caching in UI Automation

Conceitos

Visão Geral de Padrões de Controle de Automação de Interface de Usuário

Padrões de Controle para Clientes de Automação de IU

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