--- title: "SplitContainer Control Overview" ms.date: "03/30/2017" f1_keywords: - "SplitContainer" helpviewer_keywords: - "SplitContainer control [Windows Forms], about SplitContainer control" ms.assetid: 6de5a5f7-97a5-402d-be6d-7e2785483db5 --- # SplitContainer Control Overview (Windows Forms) The Windows Forms control can be thought of as a composite; it is two panels separated by a movable bar. When the mouse pointer is over the bar, the pointer changes shape to show that the bar is movable. > [!IMPORTANT] > In the **Toolbox**, control replaces the control that was there in the previous version of Visual Studio. The control is much preferred over the control. The class is still included in the .NET Framework for compatibility with existing applications, but we strongly encourage you to use the control for new projects. With the control, you can create complex user interfaces; often, a selection in one panel determines what objects are shown in the other panel. This arrangement is very effective for displaying and browsing information. Having two panels lets you aggregate information in areas, and the bar, or "splitter," makes it easy for users to resize the panels. More than one control can also be nested, with the second control oriented horizontally, to create top and bottom panels. Be aware that the control is keyboard-accessible by default; users can press the ARROW keys to move the splitter if the property is set to `false`. The property of the control determines the direction of the splitter, not of the control itself. Hence, when this property is set to , the splitter runs from top to bottom, creating left and right panels. Additionally, be aware that the value of the property varies depending on the value of the property. For more information, see property. You can also restrict the size and movement of the control. The property determines which panel will remain the same size after the control is resized, and the property determines if the splitter is movable by the keyboard or mouse. > [!NOTE] > Even if the property is set to `true`, the splitter may still be moved programmatically; for example, by using the property. Finally, each panel of the control has properties to determine its individual size. ## Commonly Used Properties, Methods, and Events |Name|Description| |----------|-----------------| | property|Determines which panel will remain the same size after the control is resized.| | property|Determines if the splitter can be moved with the keyboard or mouse.| | property|Determines if the splitter is arranged vertically or horizontally.| | property|Determines the distance in pixels from the left or upper edge to the movable splitter bar.| | property|Determines the minimum distance, in pixels, that the splitter can be moved by the user.| | property|Determines the thickness, in pixels, of the splitter.| | event|Occurs when the splitter is moving.| | event|Occurs when the splitter has moved.| ## See also - - [SplitContainer Control](splitcontainer-control-windows-forms.md) - [SplitContainer Control Sample](/previous-versions/visualstudio/visual-studio-2008/0ffz7d1b(v=vs.90))