Compartilhar via


Padrão de controle de encaixe

Descreve diretrizes e convenções para implementar IDockProvider, incluindo informações sobre propriedades e métodos. O padrão de controle Dock é usado para expor as propriedades de encaixe 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. A imagem a seguir mostra um contêiner de encaixe com dois elementos filho. Para obter exemplos de controles que implementam esse padrão de controle, consulte tipos de controle e seus padrões de controle com suporte.

captura de tela mostrando o contêiner de encaixe com duas crianças encaixadas

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

Diretrizes e convenções de implementação

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

  • IDockProvider não expõe nenhuma propriedade do contêiner de encaixe ou quaisquer propriedades de controles que estejam encaixadas adjacentes ao controle atual dentro do contêiner de encaixe.
  • Os controles são encaixados uns com os outros com base na ordem z atual; quanto maior o posicionamento da ordem z, mais distantes eles são colocados da borda especificada do contêiner de encaixe.
  • Se o contêiner de encaixe for redimensionado, todos os controles encaixados dentro do contêiner serão reposicionados para a mesma borda na qual foram encaixados originalmente. Os controles encaixados também serão redimensionados para preencher qualquer espaço dentro do contêiner de acordo com o comportamento de encaixe de sua propriedade DockPosition. Por exemplo, se DockPosition_Top for especificado, os lados esquerdo e direito do controle se expandirão para preencher qualquer espaço disponível. Se DockPosition_Fill for especificado, todos os quatro lados do controle se expandirão para preencher qualquer espaço disponível.
  • Em um sistema de vários monitores, os controles devem encaixar no lado esquerdo ou direito do monitor atual. Se isso não for possível, eles deverão encaixar no lado esquerdo do monitor mais à esquerda ou no lado direito do monitor mais à direita.

Membros necessários para IDockProvider

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

Membros necessários Tipo de membro Anotações
DockPosition Propriedade Nenhum
SetDockPosition Método Nenhum

 

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

tipos de controle e seus padrões de controle com suporte

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

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