Implementing SplitContainerAdv in Windows Forms

When to Use This Skill

• Create a resizable split-panel layout in a Windows Forms application
• Add controls to separate panels within a container
• Allow users to resize panels by dragging the splitter
• Configure horizontal or vertical panel orientation
• Customize splitter appearance and behavior
• Collapse or expand panels dynamically
• Handle panel resize events

Component Overview

• Two resizable panels (Panel1 and Panel2) separated by a splitter
• Support for horizontal and vertical orientation
• Panel collapsing/expanding capabilities
• Rich customization of splitter appearance
• Event handling for splitter movements
• Nested container support (SplitContainerAdv within SplitContainerAdv)
• Visual styling options

Documentation and Navigation Guide

Getting Started

• Assembly dependencies and NuGet setup
• Creating a new Windows Forms project
• Adding SplitContainerAdv via designer
• Adding SplitContainerAdv programmatically
• Adding child controls to panels
• Setting splitter orientation

Panel Configuration

• Panel orientation (horizontal vs vertical)
• Fixed and resizable panels
• Minimum panel size constraints
• Collapsing and expanding panels at runtime
• Panel-specific properties and behavior

Splitter Customization

• Splitter distance and positioning
• Fixed splitter configuration
• Splitter width and increment settings
• Thumbnail arrow and grip appearance
• Hover state customization
• Runtime appearance changes

Appearance and Styling

• Background color configuration
• Foreground properties (fonts, colors)
• Border styling options
• Panel-specific appearance overrides
• Gradient and brush customization

Events and Interactions

• SplitterMoved event handling
• SplitterMoving event handling
• Common event patterns
• Event args and data access
• Preventing splitter movement

Quick Start Example

// Create and configure SplitContainerAdv
SplitContainerAdv splitContainer = new SplitContainerAdv();
splitContainer.Dock = DockStyle.Fill;
splitContainer.Orientation = Orientation.Horizontal;
splitContainer.SplitterDistance = 150;

// Add controls to panels
Label label1 = new Label { Text = "Panel 1", Dock = DockStyle.Fill };
Label label2 = new Label { Text = "Panel 2", Dock = DockStyle.Fill };

splitContainer.Panel1.Controls.Add(label1);
splitContainer.Panel2.Controls.Add(label2);

// Add to form
this.Controls.Add(splitContainer);

' Create and configure SplitContainerAdv
Dim splitContainer As New SplitContainerAdv()
splitContainer.Dock = DockStyle.Fill
splitContainer.Orientation = Orientation.Horizontal
splitContainer.SplitterDistance = 150

' Add controls to panels
Dim label1 As New Label With {.Text = "Panel 1", .Dock = DockStyle.Fill}
Dim label2 As New Label With {.Text = "Panel 2", .Dock = DockStyle.Fill}

splitContainer.Panel1.Controls.Add(label1)
splitContainer.Panel2.Controls.Add(label2)

' Add to form
Me.Controls.Add(splitContainer)

Common Patterns

Pattern 1: Fixed Left Panel, Resizable Right Panel

splitContainer.Orientation = Orientation.Vertical;
splitContainer.FixedPanel = FixedPanel.Panel1;
splitContainer.Panel1MinSize = 200;
splitContainer.SplitterDistance = 200;

Pattern 2: Collapsible Panels

splitContainer.PanelToBeCollapsed = CollapsedPanel.Panel2;
splitContainer.TogglePanelOn = TogglePanelOn.DoubleClick;

Pattern 3: Vertical Layout with Equal Sizing

splitContainer.Orientation = Orientation.Vertical;
splitContainer.SplitterDistance = splitContainer.Height / 2;
splitContainer.Panel1MinSize = 50;
splitContainer.Panel2MinSize = 50;

Key Properties

Orientation

SplitterDistance

FixedPanel

Panel1Collapsed

Panel2Collapsed

IsSplitterFixed

SplitterWidth

Panel1MinSize

Panel2MinSize

ExpandFill

HotGripDark

Quick Tips

• Default Orientation: Use

  Orientation.Horizontal

  for left-right split,

  Orientation.Vertical

  for top-bottom
• Minimum Sizing: Set

  Panel1MinSize

  and

  Panel2MinSize

  to prevent panels from collapsing too small
• Fixed Panels: Use

  FixedPanel

  to prevent resizing one side, useful for toolbars or sidebars
• Panel Collapse: Double-click the splitter to collapse when

  TogglePanelOn = TogglePanelOn.DoubleClick

• Nested Containers: Add a SplitContainerAdv to a panel of another SplitContainerAdv for complex layouts
• Docking: Use

  Dock = DockStyle.Fill

  to make the control fill its parent container