Compartilhar via


Como definir o comportamento de redimensionamento e posicionamento em uma janela dividida

Os painéis do SplitContainer controle se prestam bem a serem redimensionados e manipulados pelos usuários. No entanto, há momentos em que é útil controlar o divisor com programação, onde ele está posicionado e em que grau pode ser movido.

A SplitterIncrement propriedade e as outras propriedades no SplitContainer controle fornecem controle preciso sobre o comportamento da interface do usuário para atender às suas necessidades. Esses cmdlets estão listados na tabela a seguir.

Nome Descrição
Propriedade IsSplitterFixed Determina se o divisor pode ser movido com o teclado ou mouse.
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.

O exemplo abaixo modifica a SplitterIncrement propriedade para criar um efeito de "divisor de encaixe", quando o usuário arrasta o divisor, ele incrementa em unidades de 10 pixels em vez do padrão 1.

Definir o comportamento de redimensionamento do SplitContainer

  1. Em um procedimento, defina a SplitterIncrement propriedade para o tamanho desejado, de modo que o comportamento de 'encaixe' do divisor seja alcançado.

    No exemplo de código a seguir, dentro do evento do formulário, o divisor dentro do LoadSplitContainer controle é definido para saltar 10 pixels quando arrastado.

    Private Sub Form1_Load(ByVal sender As System.Object, _  
        ByVal e As System.EventArgs) Handles MyBase.Load  
        Dim splitSnapper as new SplitContainer()  
        splitSnapper.SplitterIncrement = 10  
        splitSnapper.Dock = DockStyle.Fill  
        splitSnapper.Parent = me  
    End Sub  
    
    private void Form1_Load(System.Object sender, System.EventArgs e)  
    {  
        SplitContainer splitSnapper = new SplitContainer();  
        splitSnapper.SplitterIncrement = 10;  
        splitSnapper.Dock = DockStyle.Fill;  
        splitSnapper.Parent = this;  
    }  
    

    (Visual C#) Coloque o código a seguir no construtor do formulário para registrar o manipulador de eventos.

    this.Load += new System.EventHandler(this.Form1_Load);  
    

    Mover o divisor ligeiramente para a esquerda ou direita não terá nenhum efeito; no entanto, quando o ponteiro do mouse se move em 10 pixels em qualquer direção, o divisor se ajustará à nova posição.

Confira também