Implementando o padrão de controle de dock de automação da interface do usuário
Nota
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 System.Windows.Automation namespace. Para obter as informações mais recentes sobre a automação da interface do usuário, consulte API de automação do Windows: automação da interface do usuário.
Este tópico apresenta diretrizes e convenções para implementação IDockProvider, incluindo informações sobre propriedades. Links para referências adicionais estão listados no final do tópico.
O DockPattern padrão de controle é usado para expor as propriedades do dock de um controle dentro de um contêiner de encaixe. Um contêiner de encaixe é um controle que permite organizar elementos filho horizontal e verticalmente, em relação uns aos outros. Para obter exemplos de controles que implementam esse padrão de controle, consulte Mapeamento de padrão de controle para clientes de automação da interface do usuário.
Exemplo de encaixe do Visual Studio onde a janela "Class View" é DockPosition.Right e a janela "Error List" é DockPosition.Bottom
Orientações e convenções de aplicação
Ao implementar o padrão de controle Dock, observe as seguintes diretrizes e convenções:
IDockProvider não expõe quaisquer propriedades do contêiner de encaixe ou quaisquer propriedades de controles que estão encaixados adjacentes ao controle atual dentro do contêiner de encaixe.
Os controles são encaixados uns em relação aos outros com base em sua ordem z atual; Quanto maior for a sua colocação de ordem Z, mais longe eles são colocados da borda especificada do contêiner de ancoragem.
Se o contêiner de ancoragem for redimensionado, todos os controles encaixados dentro do contêiner serão reposicionados na mesma borda à qual foram originalmente ancorados. Os controles encaixados também serão redimensionados para preencher qualquer espaço dentro do contêiner de acordo com o comportamento de ancoragem de seu DockPosition. Por exemplo, se Top for especificado, os lados esquerdo e direito do controle serão expandidos para preencher qualquer espaço disponível. Se Fill for especificado, todos os quatro lados do controle serão expandidos para preencher qualquer espaço disponível.
Em um sistema com vários monitores, os controles devem se encaixar no lado esquerdo ou direito do monitor atual. Se isso não for possível, eles devem encaixar no lado esquerdo do monitor mais à esquerda ou no lado direito do monitor mais à direita.
Membros necessários para IDockProvider
As propriedades e métodos a seguir são necessários para implementar a interface IDockProvider.
| Membros obrigatórios | Tipo de membro | Notas |
|---|---|---|
| DockPosition | Property | Nenhuma |
| SetDockPosition | Método | Nenhuma |
Esse padrão de controle não tem eventos associados.
Exceções
Os provedores devem lançar as seguintes exceções.
| Tipo de exceção | Condição |
|---|---|
| InvalidOperationException | SetDockPosition - Quando um controle não é capaz de executar o estilo de doca solicitado. |
Consulte também
- Visão geral dos padrões de controle de automação da interface do usuário
- Suporte a 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
- Usar cache na automação da interface do usuário