Splitter Constructor
Collapse the table of content
Expand the table of content

Splitter Constructor

Initializes a new instance of the Splitter class.

[Visual Basic]
Public Sub New()
[C#]
public Splitter();
[C++]
public: Splitter();
[JScript]
public function Splitter();

Remarks

By default, the MinSize and MinExtra properties are set to 25. The Dock property is set to DockStyle.Left by default.

Example

[Visual Basic, C#, C++] The following example uses a Splitter control in combination with TreeView and ListView controls to create a window similar to Windows Explorer. To identify the TreeView and ListView controls, nodes and items are added to both controls. The example uses the MinExtra and MinSize properties of the Splitter to prevent the TreeView or ListView control from being sized too small or too large. This example assumes that the method created in this example is defined within a Form and that the method is called from the constructor of the Form.

[Visual Basic] 
Private Sub CreateMySplitControls()
   ' Create TreeView, ListView, and Splitter controls.
   Dim treeView1 As New TreeView()
   Dim listView1 As New ListView()
   Dim splitter1 As 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.
   Me.Controls.AddRange(New Control() {listView1, splitter1, treeView1})
End Sub 'CreateMySplitControls


[C#] 
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.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});
}

[C++] 
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->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(S"TreeView Node");
        listView1->Items->Add(S"ListView Item");

        // Add the controls in reverse order to the form to ensure proper location.

        Control* temp0 [] = {listView1, splitter1, treeView1};
        this->Controls->AddRange(temp0);
    }

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

Splitter Class | Splitter Members | System.Windows.Forms Namespace

Show:
© 2016 Microsoft