Partilhar via

Visão geral do controle SplitContainer (Windows Forms)

  • Artigo

O controle SplitContainer Windows Forms pode ser pensado como um compósito; São dois painéis separados por uma barra móvel. Quando o ponteiro do mouse está sobre a barra, o ponteiro muda de forma para mostrar que a barra é móvel.

Importante

No Toolbox, SplitContainer controle substitui o controle Splitter que estava lá na versão anterior do Visual Studio. O controle SplitContainer é muito preferido sobre 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; Muitas vezes, uma seleção em um painel determina quais objetos são mostrados no outro painel. Este arranjo é 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.

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

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

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

Além disso, esteja ciente 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 de SplitContainer. A propriedade FixedPanel determina qual painel permanecerá do mesmo tamanho depois que o controle de SplitContainer for redimensionado e a propriedade IsSplitterFixed determina se o divisor é movível pelo teclado ou mouse.

Observação

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

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

Propriedades, métodos e eventos comumente usados

Nome Descrição
FixedPanel propriedade Determina qual painel permanecerá do mesmo tamanho depois que o controle de SplitContainer for redimensionado.
IsSplitterFixed propriedade Determina se o divisor pode ser movido com o teclado ou mouse.
Orientation propriedade Determina se o divisor está disposto vertical ou horizontalmente.
SplitterDistance propriedade Determina a distância em pixels da borda esquerda ou superior até a barra divisória móvel.
SplitterIncrement propriedade Determina a distância mínima, em pixels, que o divisor pode ser movido pelo usuário.
SplitterWidth propriedade Determina a espessura, em pixels, do divisor.
SplitterMoving evento Ocorre quando o divisor está em movimento.
SplitterMoved evento Ocorre quando o divisor se moveu.

Ver também