Partilhar via

Visão geral do controle SplitContainer (Windows Forms)

  • Artigo

O controle SplitContainer dos Windows Forms pode ser considerado uma composição; são dois painéis separados por uma barra móvel. Quando o ponteiro do mouse passa sobre a barra, ele muda de forma para mostrar que a barra é móvel.

Importante

Na caixa de ferramentas, SplitContainer o controle substitui o Splitter controle que estava lá na versão anterior do Visual Studio. O SplitContainer controle é muito preferido sobre o Splitter controle. A Splitter classe ainda está incluída no .NET Framework para compatibilidade com aplicativos existentes, mas recomendamos fortemente que você use o SplitContainer controle para novos projetos.

Com o SplitContainer controle, você pode criar interfaces de usuário complexas, muitas vezes, uma seleção em um painel determina quais objetos são mostrados no outro painel. Essa disposição é muito eficiente para exibir e procurar informações. Ter dois painéis permite agregar as informações em áreas e a barra, ou “divisor”, tornando mais fácil para os usuários redimensionar os painéis.

Mais de um SplitContainer controle também pode ser aninhado, com o segundo SplitContainer controle orientado horizontalmente, para criar painéis superiores e inferiores.

Lembre-se de que o controle é acessível pelo teclado por padrão, os usuários podem pressionar as teclas de seta para mover o SplitContainer divisor se a IsSplitterFixed propriedade estiver definida como false.

A Orientation propriedade do controle determina a direção do SplitContainer divisor, não do controle em si. Assim, quando essa propriedade é definida como Vertical, o divisor é executado de cima para baixo, criando painéis esquerdo e direito.

Além disso, saiba que o SplitterRectangle valor do imóvel varia de acordo com o valor do Orientation imóvel. Para obter mais informações, consulte SplitterRectangle propriedade.

Você também pode restringir o tamanho e o movimento do SplitContainer controle. A FixedPanel propriedade determina qual painel permanecerá do mesmo tamanho depois que o controle for redimensionado e a IsSplitterFixed propriedade determina se o SplitContainer divisor é móvel pelo teclado ou mouse.

Observação

Mesmo que a propriedade esteja definida como true, o divisor ainda pode ser movido programaticamente, por exemplo, usando a SplitterDistanceIsSplitterFixed propriedade.

Finalmente, cada painel do SplitContainer controle tem propriedades para determinar seu tamanho individual.

Propriedades, métodos e eventos normalmente usados

Nome Descrição
Propriedade FixedPanel Determina qual painel permanecerá do mesmo tamanho depois que o SplitContainer controle for redimensionado.
Propriedade IsSplitterFixed Determina se o divisor pode ser movido com o teclado ou mouse.
Propriedade Orientation Determina se o separador é disposto na vertical ou horizontal.
Propriedade SplitterDistance Determina a distância em pixels da borda esquerda ou superior para o divisor móvel.
Propriedade SplitterIncrement Determina a distância mínima, em pixels, que o divisor pode ser movido pelo usuário.
Propriedade SplitterWidth Determina a espessura, em pixels, do separador.
Evento SplitterMoving Ocorre quando o separador está sendo movido.
Evento SplitterMoved Ocorre quando o separador foi movido.

Confira também