Compartilhar via

Visão geral do controle SplitContainer (Windows Forms)

  • Artigo

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

Importante

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

Com o controle SplitContainer, você pode criar interfaces de usuário complexas; geralmente, uma seleção em um painel determina quais objetos são mostrados no outro painel. Essa disposição é muito eficaz para exibir e navegar informações. Ter dois painéis permite agregar informações em áreas, e a barra, ou "divisor", facilita o redimensionamento dos painéis pelos usuários.

Mais de um controle SplitContainer pode ser aninhado, com o segundo controle SplitContainer orientado horizontalmente, para criar painéis na parte superior e inferior.

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

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

Além disso, lembre-se de que o valor da propriedade SplitterRectangle varia dependendo do valor da propriedade Orientation. Para obter mais informações, consulte a propriedade SplitterRectangle.

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

Nota

Mesmo que a propriedade IsSplitterFixed esteja definida como true, o divisor ainda poderá ser movido programaticamente; por exemplo, usando a propriedade SplitterDistance.

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

Propriedades, métodos e eventos comumente usados

Nome Descrição
propriedade FixedPanel Determina qual painel permanecerá do mesmo tamanho depois que o controle SplitContainer for redimensionado.
propriedade IsSplitterFixed Determina se o divisor pode ser movido com o teclado ou o mouse.
propriedade Orientation Determina se o divisor é organizado vertical ou horizontalmente.
propriedade SplitterDistance Determina a distância em pixels da borda esquerda ou superior até a barra de 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 divisor.
evento SplitterMoving Ocorre quando o separador está se movendo.
evento SplitterMoved Ocorre quando o divisor é movido.

Consulte também