Click here to Skip to main content
Click here to Skip to main content

DockPanel Splitter Control for WPF

, 10 Aug 2009
Rate this:
Please Sign up or sign in to vote.
A splitter control for the WPF DockPanel
Sample Image

Introduction

This control adds size adjustment functionality to elements of a DockPanel in the same way a GridSplitter can adjust the size of columns and rows in a Grid. When resizing the parent container, the elements will be resized proportionally unless the ProportionalResize property is set to False.

Using the Code

Add the OpenSourceControls namespace and add a DockPanelSplitter control after each panel you want to adjust. The DockPanel.Dock attribute controls which edge of the panel the splitter works on.

<Window x:Class="DockPanelSplitterDemo.Window1"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:osc="clr-namespace:OpenSourceControls"
    Title="DockPanelSplitter demo" Height="400" Width="600">
    <DockPanel>
        <Grid Name="LeftPane" DockPanel.Dock="Left" 
                      Width="200" MinWidth="40">
            <Rectangle Fill="LightBlue"/>
        </Grid>
        <osc:DockPanelSplitter DockPanel.Dock="Left" Width="4"/>
 
        <Grid Name="RightPane" DockPanel.Dock="Right" Width="80">
            <Rectangle Fill="Yellow"/>
        </Grid>
        <osc:DockPanelSplitter DockPanel.Dock="Right" Width="4"/>
        
        <Grid Name="TopPane" DockPanel.Dock="Top" 
                     Height="80" MinHeight="20">
            <Rectangle Fill="LightGreen"/>
        </Grid>
        <osc:DockPanelSplitter DockPanel.Dock="Top" Height="4"/>
        
        <Grid Name="BottomPane" DockPanel.Dock="Bottom" Height="70">
            <Rectangle Fill="LightPink"/>
        </Grid>
        <osc:DockPanelSplitter DockPanel.Dock="Bottom" Height="4"/>
        
        <Grid Name="MainPane" Background="Coral" >
            <Rectangle Fill="Coral"/>
        </Grid>
    </DockPanel>
</Window>

The proportional sizing mode can be turned off by setting the ProprtionalResize dependency property to False.

<osc:DockPanelSplitter DockPanel.Dock="Right" Width="4" ProportionalResize="False"/>

Links to Related Projects

  • WpfContrib DockSplitter (cannot find the control in ProportionalResize dependency property to False. Creating resizable panels with splitter bars (links don't work??)
  • Thumb example

Future Enhancements

  • Use the Thumb control instead of capturing mouse events

History

  • March 21, 2009 - First post
  • May 25, 2009 - Added proportional resizing
  • August 09, 2009 - Changed to custom control, added template demo, constrained size on client area

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

About the Author

objo

Norway Norway
No Biography provided

Comments and Discussions

 
GeneralRe: silverlight Pinmemberdaniel Moody17-Jul-12 9:58 
GeneralSplitter movement restriction PinmemberPrasoon Chaudhary29-Apr-10 9:06 
GeneralSystem.ArgumentException was unhandled Pinmemberkiol28-Jan-10 22:40 
GeneralRe: System.ArgumentException was unhandled Pinmemberobjo2-Feb-10 4:29 
GeneralRe: System.ArgumentException was unhandled PinmemberHHick1234512-May-10 1:42 
GeneralCode Behind PinmemberJason McPeak15-Dec-09 3:41 
GeneralRe: Code Behind PinmemberJason McPeak15-Dec-09 4:39 
AnswerRe: Code Behind Pinmemberobjo15-Dec-09 4:53 
NewsRe: Code Behind PinmemberJason McPeak15-Dec-09 5:05 
GeneralRe: Code Behind PinmemberJason McPeak15-Dec-09 5:44 
GeneralRe: Code Behind PinmemberJason McPeak15-Dec-09 5:58 
GeneralWell done! Pinmemberbrents11-Dec-09 14:25 
GeneralTo add this code to your own assembly... PinmemberSerialHobbyist17-Aug-09 3:02 
AnswerRe: To add this code to your own assembly... Pinmemberobjo17-Aug-09 6:33 
GeneralRe: To add this code to your own assembly... PinmemberJason McPeak15-Dec-09 4:48 
GeneralRe: To add this code to your own assembly... Pinmemberobjo15-Dec-09 4:57 
GeneralOpen Source SplitContainer PinmemberWeifen Luo10-Aug-09 16:00 
GeneralRe: Open Source SplitContainer Pinmemberobjo10-Aug-09 20:45 
GeneralMy vote of 2 Pinmemberdartrax6-Aug-09 4:19 
AnswerRe: resizing out of client area Pinmemberobjo9-Aug-09 9:57 
QuestionIs there a way to change the appearance of the DockPanel splitter? PinmemberChris Boarman20-Jul-09 16:22 
AnswerRe: Is there a way to change the appearance of the DockPanel splitter? Pinmemberobjo21-Jul-09 20:11 
GeneralIs ProprtionalResize setting can be set independently for each panel ??? like the dock position (Dock.right for ex.) PinmemberSazuke-kun30-May-09 15:42 
GeneralRe: Is ProprtionalResize setting can be set independently for each panel ??? like the dock position (Dock.right for ex.) PinmemberSazuke-kun30-May-09 15:46 
Generalhi very nice but :) PinmemberSazuke-kun24-May-09 16:53 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Mobile
Web02 | 2.8.140718.1 | Last Updated 10 Aug 2009
Article Copyright 2009 by objo
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid