Compartilhar via


Padrão de controle de encaixe

Descreve as diretrizes e convenções para implementar o 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 dois filhos encaixados

Este tópico inclui 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 encaixados adjacentes ao controle atual dentro do contêiner de encaixe.
  • Os controles são encaixados uns aos 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 na mesma borda à 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 serão expandidos para preencher qualquer espaço disponível.
  • Em um sistema de vários monitores, os controles devem ser encaixados no lado esquerdo ou direito do monitor atual. Se isso não for possível, eles devem ser encaixados 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 IDockProvider .

Membros necessários Tipo de membro Observaçõ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 de Padrões de Controle de Automação de Interface de Usuário

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