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, haverá momentos em que você desejará controlar programaticamente o divisor , onde ele está posicionado e até que ponto ele 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. Essas propriedades são listadas na tabela a seguir.

Nome Descrição
Propriedade IsSplitterFixed Determina se o divisor é móvel por meio do teclado ou mouse.
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.

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

Para definir o comportamento de redimensionamento do SplitContainer

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

    No exemplo de código a seguir, dentro do evento do Load formulário, o divisor dentro do SplitContainer controle foi configurado 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 perceptível; no entanto, quando o ponteiro do mouse for 10 pixels em uma das direções, o divisor se alinhará à nova posição.

Consulte também