Compartilhar via

Visão geral do controle SplitContainer (Windows Forms)

O controle do Windows Forms SplitContainer 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, SplitContainer o controle substitui o Splitter controle que estava lá na versão anterior do Visual Studio. O controle SplitContainer é muito mais preferido do que o controle Splitter. A Splitter classe ainda está incluída no .NET Framework para compatibilidade com aplicativos existentes, mas incentivamos você a usar o SplitContainer controle para novos projetos.

Com o SplitContainer controle, 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 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 SplitContainer controle é acessível pelo teclado por padrão; os usuários podem pressionar as teclas ARROW para mover o divisor se a IsSplitterFixed propriedade estiver definida como false.

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

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

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

Observação

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

Por fim, cada painel do SplitContainer controle 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 SplitContainer controle 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 divisor está se movendo.
Evento SplitterMoved Ocorre quando o divisor é movido.

Consulte também

  • Last updated on