Click here to Skip to main content
11,432,119 members (60,504 online)
Click here to Skip to main content

NavigationTree Control

, 28 Mar 2006
Rate this:
Please Sign up or sign in to vote.
A control providing a different kind of navigation in your app.

the NavigationTree control used in the demo project

Introduction

This control provides a new kind of navigation for your applications. It uses the TreeNodes of a TreeView to offer functionality to the user.

Background

I saw this control in a commercial application, and I liked the look and feel and the possibilities it gives to the programmer. Because I didn't see such a control anywhere else, I decided to develop one on my own and use it in one of my projects. I hope others like my NavigationTree, too.

Using the code

When using a NavigationTree, you have to define categories and items. Categories are represented by NavigationCategory objects, and items are represented by NavigationItem objects. Each item is owned by a category, and the categories are owned by the NavigationTree. Items can be organized hierarchically.

object hierarchy

Use categories to represent different parts of your application (like 'Customers', 'Manufacturers', 'Stock', an so on), and items to represent topics within a category (like 'customer list', 'search customer', 'new customer'). When a category is selected, its items will be displayed and the category header will be set.

When an item is selected, an event will be fired and your app can react on this event (e.g., display the customer list). You can use ImageLists to assign icons to NavigationItems and NavigationCategorys.

elements of the NavigationTree

At the moment, NavigationCategorys and NavigationItems can only be added by code at runtime:

NavigationCategory c1 = new NavigationCategory("Customers", 0);
c1.Name = "catCustomer";

NavigationItem i = new NavigationItem("Master Data", 0);
i.AddChild(new NavigationItem("Customer List", 1));
i.AddChild(new NavigationItem("Details", 2));

c1.AddItem(i);
c1.AddItem(new NavigationItem("Orders", 3));
c1.AddItem(new NavigationItem("Invoices", 4));

navigationTree1.AddCategory(c1);

Add delegates to be informed when a NavigationItem is going to be selected, a NavigationItem has been selected, or a NavigationCategory has been selected:

// NavigationCategory has been selected
navigationTree1.OnCategorySelected += new 
   CategorySelected(navigationTree1_OnCategorySelected);

// NavigationItem is going to be selected
navigationTree1.OnBeforeItemSelect += new 
   BeforeItemSelect(navigationTree1_OnBeforeItemSelect);

// NavigationItem has been selected
navigationTree1.OnItemSelected += new 
   ItemSelected(navigationTree1_OnItemSelected);

You can select NavigationItems by code:

// select a NavigationItem and fire
// BeforeItemSelect and ItemSelected events
myNavItem.Select();
// select a NavigationItem without fireing events (silent mode)
myNavItem.Select(false);

You can change the Text property of a NavigationItems by code:

// change the visible text of a NavigationItem...
myNavItem.Text = "a new text";
// ...and update this NavigationItem in the NavigationTree
myNavItem.Refresh();

Points of Interest

I improved the NavigationTree step by step, as more functionality was needed in my project, so some parts of the source look rather wild and are not well documented. I'm going to improve the source when posting future versions. Suggestions, improvements, and bug reports are welcome.

History

  • 3/28/06 - version 1.0 and demo project posted on CodeProject.

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here

Share

About the Author

Jürgen Müller (jmse)
Web Developer
Germany Germany
Software developer, IT trainer and IT consultant since 1994. Most used programming languages are C#, VB 6.0 and Java.


Comments and Discussions

 
GeneralTake a look at this Pin
CarlosI17-Oct-06 15:19
memberCarlosI17-Oct-06 15:19 

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
Web04 | 2.8.150428.2 | Last Updated 28 Mar 2006
Article Copyright 2006 by Jürgen Müller (jmse)
Everything else Copyright © CodeProject, 1999-2015
Layout: fixed | fluid