Compartilhar via


Visão geral do controle SplitContainer (Windows Forms)

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

Observação importanteImportante

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

Com o SplitContainer o controle, você pode criar interfaces do usuário complexa; Geralmente, uma seleção em um painel determina quais objetos são mostrados no painel de. Essa organização é bastante eficaz para exibir e procurar informações. Ter dois painéis permite a você agregar informações em áreas e a barra ou "divisor" torna mais fácil para os usuários redimensionar os painéis.

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

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

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

Além disso, esteja ciente de que o valor da SplitterRectangle propriedade varia de acordo com o valor da Orientation propriedade. Para obter mais informações, consulte SplitterRectangle propriedade.

Você também pode restringir o tamanho e a movimentação da SplitContainer de controle. O FixedPanel propriedade determina qual painel permanecerá o mesmo tamanho após a SplitContainer controle for redimensionado e o IsSplitterFixed propriedade determina se o divisor é móvel pelo teclado ou mouse.

ObservaçãoObservação

Mesmo se o IsSplitterFixed for definida como true, o divisor ainda pode ser movido por programação; Por exemplo, usando o SplitterDistance propriedade.

Finalmente, cada painel da SplitContainer controle tem propriedades para determinar o tamanho individual.

Propriedades, métodos e eventos utilizados

Nome

Descrição

Propriedade FixedPanel

Determina qual painel permanecerá o mesmo tamanho após a SplitContainer controle for redimensionado.

Propriedade IsSplitterFixed

Determina se o divisor pode ser movido com o teclado ou mouse.

Propriedade Orientation

Determina se o divisor é organizado verticalmente ou horizontalmente.

Propriedade SplitterDistance

Determina a distância em pixels da borda esquerda ou superior para a barra divisora 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 foi movido.

Consulte também

Tarefas

SplitContainer Control Sample

Referência

SplitContainer

Outros recursos

Controle SplitContainer (Windows Forms)