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

A Visual Studio 2005-like Interface

, 22 Jan 2007 CPOL
Rate this:
Please Sign up or sign in to vote.
Apply a theme that resembles Visual Studio 2005 to the DockPanel Suite, using an Extender class.
Sample Image - DockPanelSkin.png

Overview

It's now been awhile since programs like Opera, Firefox and other software introduced MDI tabbed interfaces. Unluckily, there are not too many free components that allow .NET developers to create such interfaces. I was searching the internet for a long time before discovering the DockPanel Suite, a wonderful and fully customizable component from Weifen Luo. This component is available on Sourceforge, here.

Introduction

This article shows how the DockPanel component can be customized, implementing an Extender class. The attached example creates a Visual Studio 2005 like interface against version 1.0 of the DockPanel.

Copyright

Weifen Luo is the owner of the copyright for the DockPanel Suite, which includes the Extender class, the object of this article.

Background

This article is based around the DockPanel Suite library and it requires at least a basic knowledge of this. Please refer to the References paragraph to find more information about it. A good knowledge of the System.Drawing classes and functions is also required.

The Extender Class

DockPanel accepts customizations through five classes:

  • AutoHideTab represents a single tab used when the content is in the autohide state.
  • AutoHideStrip draws tabstrips and tabs when the content is in the autohide state.
  • DockPaneCaption draws the caption pane when the contents are tool windows.
  • DockPaneTab represent a single tab used when the content is a document window or a tool window.
  • DockPaneStrip draws tabstrips and tabs when the content is a document window or a tool window.

For convenience, these classes are enclosed in an Extender class. The following sections describe the component parts and the relative modules you can customize.

AutoHideStrip and AutoHideTab

The autohide strips can appear at the four borders of the main form and they are activated by the MouseOver event. The tabstrip will be visible only if at least one content is in the autohide state. When the tabs are docked to the left or to the right, the resulting tabs are rotated 90 degrees.

Following is a screenshot of a form docked to the top:

Here is another example of a form docked to the bottom:

The drawing of tabstrips and tabs is done by the class AutoHideStripFromBase. The painting methods are mainly the following:

  • OnPaint handles the OnPaint event of the control.
  • DrawTabStrip draws the tabstrips with a right orientation and all the contained tabs.
  • DrawTab draws a single tab.

DockPaneCaption

DockPaneCaption represents the form border when the form is docked and it normally contains a title, a button to close the window and a button to set the window to the autohide state. The Visual Studio 2005 like interface also contains a button to manipulate the window state through a context menu.

The following is a screenshot of DockPaneCaption:

The drawing of the caption is done by the class DockPaneCaptionFromBase. The painting methods are mainly the following:

  • OnPaint handles the OnPaint event of the control.
  • DrawCaption draws the background and the caption text.

DockPaneStrip and DockPaneTab

DockPaneStrip represents the tab area shown when the content is a tool window or a document. There are many differences between these two regarding the tab shape and other behaviour. An example is hiding the tabstrip in the case of a single content. The drawing of tabstrips and tabs is done by the class DockPaneStripFromBase. The following examples will clarify these differences.

Example of a tabstrip that shows document tabs:

Example of a tabstrip that shows document tabs with an icon and the overflow symbol:

Example of a tabstrip that shows tool window tabs:

The painting methods for the document tabstrip are the following:

  • OnPaint handles the OnPaint event of the control.
  • DrawTabStrip_Document draws the background.
  • DrawTab_Document draws the shape, icon and text.

The painting methods for the tool window tabstrip are the following:

  • OnPaint handles the OnPaint event of the control.
  • DrawTabStrip_ToolWindow draws the background.
  • DrawTab_ToolWindow draws the shape, icon, and text.

Using the Code

To apply the Extender to an instance of DockPanel, insert the following code into the Form_Load event of your form, replacing the name of the control with yours.

Extender.SetSchema(DockPanel1, Extender.Schema.FromBase)

Final Notes

I hope that you find this article useful. If you find this article stupid, annoying or incorrect, express this fact by rating the article as you see fit. In the end, you're very welcome at any moment to freely contribute to this project by suggesting improvements or by submitting code or other materials.

Credits

Thanks to Weifen Luo for providing the community with the DockPanel component. If you like this component, you may want to make a donation to Weifen Luo here.

References

History

  • 3rd June 2006: first submission
  • 20th July 2006: bug fix (the MdiParent property doesn't need to be set)
  • 20nd January 2007: updated download

License

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

Share

About the Author

Danilo Corallo
Web Developer
Italy Italy
I am 29 years old and I've been working with C++, Visual Basic .NET, C# and ASP.NET. I have a large experience in Industrial Automation solutions, but I've worked also as Web developer and DBA. I like to share knowledge and projects with other people.

Comments and Discussions

 
QuestionHow to add forms and controls to them PinmemberSnehasish Nandy21-Dec-12 0:31 
Questioni need a tutorial Pinmembervahnvallain30-Aug-11 20:17 
GeneralMy vote of 5 PinmemberE$w@r24-Feb-11 17:51 
GeneralMy vote of 5 Pinmemberalifellod4-Nov-10 10:04 
Generalconvert this code to C# Pinmembersa.alavifar23-Oct-10 22:07 
GeneralMy vote of 5 Pinmembersa.alavifar23-Oct-10 21:59 
GeneralUnable to set max size of form without grey strip running along the bottom PinmemberLindseyTantrum3-Sep-10 3:09 
GeneralRe: Unable to set max size of form without grey strip running along the bottom PinmemberLindseyTantrum23-Sep-10 0:38 
QuestionPaint TitleBar PinmemberEugene Kogel23-Apr-10 16:12 
GeneralWorking with WeifenLuo.WinFormsUI.Docking.dll version 2.2.0.0 Pinmembernisad13-Oct-09 4:24 
Questionwill this work with Visual Basic 2008 Express Edition? PinmemberMember 363971330-Sep-09 14:39 
QuestionEvent Problem? No LostFocus and Leave Events on floating Windows? PinmemberSkeletor2314-Sep-09 4:51 
GeneralFor hide tab when have a single Document PinmemberPasalino9-Sep-09 3:40 
QuestionHow can i change automatically all locale files used in each one of the forms ? Pinmemberagelospanagiotakis31-Aug-09 0:33 
QuestionHow Can I Impement Dock content to Left by Extendering the DocumentTabStripLocation Enumerable with Adding Left property? Pinmemberhjzhou29-Aug-09 21:12 
Generalgreat work. =) Pinmemberfrancis314-Aug-09 22:40 
GeneralCommunication between docks Pinmemberhakimgada5-Jul-09 21:20 
GeneralDoubts.. wud be sweet if someone cud help me , please PinmemberGagan111813-Jun-09 15:43 
Generalimplement VOIP Pinmembermzamoandris1-Jun-09 4:05 
Questionhow to doc different forms Pinmemberghalibkhan14-May-09 22:05 
General[Message Deleted] PinmemberNoKindOfName21-Mar-09 18:56 
GeneralRe: How to add things Pinmembersndwchmkr2-May-09 13:08 
GeneralRe: How to add things Pinmembersndwchmkr2-May-09 13:09 
QuestionThank you! PinmemberMorgan19819-Feb-09 4:08 
AnswerRe: Thank you! PinmemberPCBuilder15-Mar-09 5:37 

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
Web04 | 2.8.141015.1 | Last Updated 22 Jan 2007
Article Copyright 2006 by Danilo Corallo
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid