SplitContainer control provides functionality of a splitter to
divide and resize two controls. In this article, we will discuss how to create
and use a SplitContainer control in a Windows Forms application.
Creating a SplitContainer
A
SplitContainer has two built-in panels and a splitter. If you drag a
SplitContainer control from Toolbox onto a Form, you will see output like
Figure 1, where a splitter is separating Panel1 and Panel2 panels.
Figure 1
Now
if you can place any child controls in Panel1 and Panel2 and you will be able
to resize them. Let's drag a TreeView control on Panel1 and ListBox control on
Panel2 and set their Dock property to true. The output looks like Figure 2. If
you run this application, you will see resizing option is available between
TreeView and ListBox controls.
Figure 2
SplitContainer
Properties
After you place a SplitContainer control on a Form, the next step
is to set properties.
The easiest way to set properties is from the Properties Window.
You can open Properties window by pressing F4 or right click on a control and
select Properties menu item. The Properties window looks like Figure 3. You can
also set properties of Panels by selecting a Panel and open the Properties
window.
Figure 3
Orientation
Panels on a SplitContainer can be placed horizontally or
vertically. The horizontal orientation places Panels like Figure 4.
Figure 4
C# Code:
splitContainer1.Orientation = Orientation.Horizontal;
VB.NET Code:
splitContainer1.Orientation = Orientation.Horizontal
Panel1 and
Panel2
A SplitContainer has two panels. The first panel is
represented by Panel1 and second panel is represented by Panel2. These panels
are a type of SplitterPanel and can have their own properties and events.
C# Code:
SplitterPanel leftPanel =
splitContainer1.Panel1;
leftPanel.BackColor = Color.Green;
leftPanel.ForeColor = Color.Yellow;
SplitterPanel rightPanel =
splitContainer1.Panel2;
rightPanel.BackColor = Color.OrangeRed;
rightPanel.ForeColor = Color.White;
VB.NET Code:
Dim leftPanel As SplitterPanel = SplitContainer1.Panel1
leftPanel.BackColor = Color.Green
leftPanel.ForeColor = Color.Yellow
Dim rightPanel As SplitterPanel = SplitContainer1.Panel2
rightPanel.BackColor = Color.OrangeRed
rightPanel.ForeColor = Color.White
Panel1Collapsed
and Panel2Collapsed
Panel1Collapsed and Panel2Collapsed properties can be used
to collapse and expand panels.
C# Code:
splitContainer1.Panel1Collapsed = true;
VB.NET Code:
splitContainer1.Panel1Collapsed = True
Panel1MinSize
and Panel2MinSize
Panel1MinSize property gets or sets the minimum distance in pixels
of the splitter from the left or top edge of Panel1. Panel2MinSize property
gets or sets the minimum distance in pixels of the splitter from the right or
bottom edge of Panel2.
C# Code:
splitContainer1.Panel1MinSize = 10;
splitContainer1.Panel2MinSize = 50;
VB.NET Code:
splitContainer1.Panel1MinSize = 10
splitContainer1.Panel2MinSize = 50
Splitter
Properties
SplitterDistance property gets or sets the location of the
splitter, in pixels, from the left or top edge of the SplitContainer.
SplitterIncrement property gets or sets a value representing the
increment of splitter movement in pixels.
SplitterRectangle property gets the size and location of the
splitter relative to the SplitContainer.
SplitterWidth property Gets or sets the width of the splitter in
pixels.
C# Code:
splitContainer1.SplitterDistance = 50;
splitContainer1.SplitterIncrement = 10;
splitContainer1.SplitterWidth = 10;
VB.NET Code:
splitContainer1.SplitterDistance = 50
splitContainer1.SplitterIncrement = 10
splitContainer1.SplitterWidth = 10
Summary
In this article, we discussed discuss use a SplitContainer control
and use its various properties.