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

Rich OutlookBar in XP and Vista style

, 2 Aug 2007 CPOL
Rate this:
Please Sign up or sign in to vote.
Creating a rich OutlookBar in XP or Vista style

Screenshot - NewScreenCapture.jpg

Introduction

I've always enjoyed using a control that behaves like the OutlookBar in Outlook. After testing and creating this, I knew that if I wanted other people to work intuitively with my programs, the OutlookBar control must look and work like the one in Outlook.

Needed properties

The control must be functional and accessible during runtime, as well as in design mode. You can resize the control in design time, so you can choose which buttons will be displayed as large buttons. The buttons can be added and changed using a collection editor. During runtime, the DropDown icon opens a context menu where you can choose which buttons will be visible. You also can open a "Navigation Pane Options" form where you can reorder the buttons.

At runtime, mouse movements must cause the buttons to repaint if needed. There are different color schemes for hovering buttons. I need large buttons and small buttons, displayed in the correct order even after resizing the control. I also want to be able to set a button in a "not allowed" state. Depending on the user of your program, you can disable certain buttons. The difference between Allowed and Enabled is that with the Allowed property set to False, you cannot see the button.

Basic structure

There are three classes in this control:

Class OutlookBarButton

This represents the instances of the separate buttons. No painting occurs in this class. The basic members of this class are:

  • Text: this is the text drawn on the button if it's in a large state. If the button is at the bottom of the control, a tooltip will be displayed with the text of the button.
  • Visible: when False, the button will not be visible in the control. You can change this value at runtime with ContextMenu using the DropDown icon.
  • Allowed: when False, this button will not be visible in the control. You cannot access this button at runtime, so you can prevent certain users from clicking a certain button.
  • Image: the image that will be displayed. It works best with a 24x24 icon or larger.
  • Rectangle: this is only accessible in the assembly. When the OutlookBar class calculates where to draw the buttons, it will give each button the rectangle that OutlookBar used to draw it. Thanks to this property, it's easy to find out which button is clicked or which button must be repainted using different colors.

Class OutlookBarButtonCollection

Representing the collection of buttons on the control, this inherits from CollectionBase. In the code, you just use the normal procedures to add or remove buttons to the control:

Dim newButton as New Altea.OutlookBarButton
With newButton
    .Text="my button"
    .Visible=False
    .Image=My.Resources.myImage
End With
me.OutlookBar1.Buttons.Add(newButton)

Or using the overloaded constructor:

Me.OutlookBar1.Buttons.Add(New Altea.OutlookBarButton("my button", 
    My.Resources.myImage))

Class OutlookBar

Inheriting from System.Windows.Forms.Control, this is the main class. You have a property called Renderer with two options: Office2003 and Office2007. In a future version, there will be a third option called Custom. You can select a button from the code:

Me.OutlookBar1.Buttons("Journal").Selected = True

This class has the most events. Events such as MouseMove, MouseDown, MouseLeave, etc. will be handled in this class. The painting also happens in this class. OutlookBar will decide which ButtonState the buttons have depending on which user action has happened:

Friend Enum ButtonState
    Passive
    Hovering
    Selected
End Enum 

The ButtonState will raise the Paint methods to use the correct colors and cursor. In the painting code, there will often be references to several rectangles. Here's an overview with this image:

Screenshot - CaptureStructure_edit.JPG

Conclusion

Try it, run it and tell me about it!

History

  • 10/02/2007: Original version posted
  • 14/07/2007: Reduced flickering, added custom rendering for colors and button height
  • 02/08/2007: Download updated

License

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

Share

About the Author

Star Vega
Software Developer
Belgium Belgium
No Biography provided

Comments and Discussions

 
GeneralRelicensing request Pinmemberroldn8-Sep-10 14:39 
GeneralPorted C# code [modified] PinmemberAndriy Protskiv6-Jan-10 3:21 
GeneralThanks... Excellent piece of code! Pinmembersglugove11-Dec-09 7:27 
GeneralC# version PinmemberStar Vega21-Sep-09 3:34 
GeneralC# Version Please!!!!! Pinmembermattdbuk21-Sep-09 2:53 
AnswerRe: C# Version Please!!!!! PinmemberStar Vega21-Sep-09 3:46 
GeneralHelp for use RighToLeft property PinmemberMammadAlimoradi24-Aug-09 8:59 
GeneralTroubles in Visual Basic 2008 PinmemberHis_Royal_Dudeness30-Jul-09 8:56 
GeneralRe: Troubles in Visual Basic 2008 [modified] Pinmemberpimb230-Aug-09 2:05 
GeneralSome questions .. PinmemberRodo3-Jul-09 14:43 
GeneralRe: Some questions .. PinmemberJiong Mai22-Jul-09 5:09 
GeneralC# Version Pinmembermurali_212-Jun-09 0:31 
GeneralRe: C# Version Pinmembercatu13-Jul-09 12:25 
QuestionHow to handle button click event ? PinmemberMember 113344011-Apr-09 19:59 
AnswerRe: How to handle button click event ? Pinmembersuperkuton11-Jul-09 22:47 
GeneralExcellent Pinmembermartin_hughes10-Apr-09 8:51 
GeneralRe: Excellent PinmemberStar Vega10-Apr-09 8:58 
GeneralAdd Sub Item Pinmemberkaleeswaramurthy25-Mar-09 19:41 
QuestionCode in C# Pinmemberjdkulkarni6-Jan-09 21:20 
AnswerRe: Code in C# Pinmemberjdkulkarni6-Jan-09 23:55 
GeneralRe: Code in C# Pinmembershuami13-Jan-09 16:20 
QuestionVisual C++ or C# Version PLEASE? PinmemberCarlBenton20-Nov-08 18:08 
GeneralDoes anybody have the C# version PinmemberAndy ufuris11-Sep-08 12:44 
GeneralSaving your added buttons? [modified] Pinmemberplanocz1-Sep-08 11:19 
GeneralRe: Saving your added buttons? PinmemberDaniel12318-Jul-09 14:44 

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 | Terms of Use | Mobile
Web01 | 2.8.1411023.1 | Last Updated 2 Aug 2007
Article Copyright 2007 by Star Vega
Everything else Copyright © CodeProject, 1999-2014
Layout: fixed | fluid