Classe Splitter

The Splitter controle permite que o usuário redimensione controles que são ancoradas nas bordas das Splitter controle em time de execução. Quando o usuário passa o ponteiro do mouse sobre o Splitter controlar o cursor é alterado para indicar que os controles encaixados o Splitter controle pode ser redimensionada. The Splitter controle permite que o usuário redimensionar o controle encaixado é imediatamente antes na ordem de encaixe. Portanto, para que o usuário redimensionar um controle encaixado, ancorar o controle que você deseja que o usuário poderá redimensionar a uma borda de um contêiner e encaixar um divisor, em seguida, ao mesmo lado desse contêiner. Por exemplo, para criar uma janela semelhante ao Windows Explorer, adicione um TreeView controle a um formulário e conjunto seus Dock propriedade para DockStyle.Left. Adicionar um Splitter controle ao formulário e conjunto seu Dock propriedade para DockStyle.Left também. Para concluir o layout do formulário, adicione um ListView controle e conjunto seu Dock propriedade para DockStyle.Fill para que o ListView ocupam o espaço restante no formulário. Em time de execução, o usuário pode, em seguida, redimensionar a largura do TreeView controle (assim sistema autônomo o ListView controle), movendo o Splitter controle.

Para garantir que o Splitter controle não redimensionar controles ancorada para um dimensionar muito pequeno para ser útil para o usuário, use o MinExtra e MinSize Propriedades. The MinExtra e MinSize propriedades determinam o dimensionar mínimo que controles são encaixados à esquerda e direita (ou superior e inferior se um horizontal Splitter controle) pode ser dimensionada. Se a outros controles no formulário que o Splitter controle está encaixado para exibir um determinado estilo de borda, você pode usar o BorderStyle propriedade para coincidir com o estilo da borda dos controles que são ancoradas a ele.

Talvez seja conveniente conjunto um limite de dimensionar máximo em controles que o Splitter controle está ancorada. The SplitterMoved e SplitterMoving eventos permitem que você determine quando o usuário está redimensionando um controle encaixado. Você pode usar o SplitPosition propriedade em um manipulador de eventos para o SplitterMoved ou SplitterMoving eventos para determinar o dimensionar do controle que o Splitter controle é encaixado e conjunto o SplitPosition propriedade para um valor diferente para limitar a largura do controle encaixado a uma largura máxima especificada (ou altura se alinhados horizontalmente Splitter controle).

Observação:
Redimensionar um controle usando o Splitter controle só pode ser concluído usando o mouse. Não é possível acessar o Splitter usando o teclado de controle.

O exemplo de código a seguir usa um Splitter controlar em combinação com TreeView e ListView controles para criar uma janela semelhante ao Windows Explorer. Para identificar o TreeView e ListView controles, nós e os itens são adicionados ao ambos os controles. O exemplo usa o MinExtra e MinSize propriedades das Splitter Para impedir que o TreeView ou ListView controle do que está sendo dimensionada muito pequenas ou muito grande. Este exemplo requer que o método criado neste exemplo é definido dentro de um Form e que é chamado o método do construtor da Form.

privatevoid CreateMySplitControls()
		{
			// Create TreeView, ListView, and Splitter controls.
			TreeView treeView1 = new TreeView();
			ListView listView1 = new ListView();
			Splitter splitter1 = new Splitter();

			// Set the TreeView control to dock to the left side of the form.
			treeView1.Dock = DockStyle.Left;
			// Set the Splitter to dock to the left side of the TreeView control.
			splitter1.Dock = DockStyle.Left;
			// Set the minimum size the ListView control can be sized to.
			splitter1.MinExtra = 100;
			// Set the minimum size the TreeView control can be sized to.
			splitter1.MinSize = 75;
			// Set the ListView control to fill the remaining space on the form.
			listView1.Dock = DockStyle.Fill;
			// Add a TreeView and a ListView item to identify the controls on the form.
            treeView1.Nodes.Add("TreeView Node");
            listView1.Items.Add("ListView Item");

			// Add the controls in reverse order to the form to ensure proper location.this.Controls.AddRange(new Control[]{listView1, splitter1, treeView1});
		}

private void CreateMySplitControls()
{
    // Create TreeView, ListView, and Splitter controls.
    TreeView treeView1 = new TreeView();
    ListView listView1 = new ListView();
    Splitter splitter1 = new Splitter();
    // Set the TreeView control to dock to the left side of the form.
    treeView1.set_Dock(DockStyle.Left);
    // Set the Splitter to dock to the left side of the TreeView control.
    splitter1.set_Dock(DockStyle.Left);
    // Set the minimum size the ListView control can be sized to.
    splitter1.set_MinExtra(100);
    // Set the minimum size the TreeView control can be sized to.
    splitter1.set_MinSize(75);
    // Set the ListView control to fill the remaining space on the form.
    listView1.set_Dock(DockStyle.Fill);
    // Add a TreeView and a ListView item to identify the controls on the 
    // form.
    treeView1.get_Nodes().Add("TreeView Node");
    listView1.get_Items().Add("ListView Item");
    // Add the controls in reverse order to the form to ensure proper 
    // location.
    this.get_Controls().AddRange(new Control[] { listView1, splitter1, 
        treeView1 });
} //CreateMySplitControls

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Pocket PC

.NET Framework

.NET Compact Framework

Referência