ICreate.Controls.Bars Send comments on this topic.
SelectedItem Property
See Also  Example
ICreate.Controls.Bars Namespace > SideBar Class : SelectedItem Property






Gets or sets the SideBarItem currently selected on the SideBar.
Gets or sets the currently selected SideBarItem.

Syntax

Visual Basic (Declaration) 
Public Property SelectedItem As SideBarItem
Visual Basic (Usage)Copy Code
Dim instance As SideBar
Dim value As SideBarItem
 
instance.SelectedItem = value
 
value = instance.SelectedItem
C# 
public SideBarItem SelectedItem {get; set;}
Delphi 
public read-write property SelectedItem: SideBarItem;
JScript 
public function get,set SelectedItem : SideBarItem
Managed Extensions for C++ 
public: __property SideBarItem* get_SelectedItem();
public: __property void set_SelectedItem( 
   SideBarItem* value
);
C++/CLI 
public:
property SideBarItem^ SelectedItem {
   SideBarItem^ get();
   void set (SideBarItem^ value);
}

Return Value

A reference to a SideBarItem, this property is the SideBarItem currently selected on the SideBar.

Example

This example shows how to use the SelectedItem property. To recreate this example add a MenuStrip to a Form. Add a View ToolStripMenuItem to the MenuStrip. Add a Mail, Contacts, Tasks and Notes ToolStripMenuItem to the View ToolStripMenuItem. Add a SideBar to the Form. Add a Mail, Contacts, Tasks and Notes SideBarItem to the SideBar. Add a CollapsingGroupPanel to the Form so that it fills the area not occupied by the SideBar. Implement the event handlers as shown below.
C#Copy Code
using System; 
using System.Windows.Forms; 
 
namespace ExamplesSideBarCSharp 
{ 
    public partial class SelectedItemPropertyExample : Form 
    { 
        public SelectedItemPropertyExample() 
        { 
            InitializeComponent(); 
        } 
 
        private void menuItemMail_Click(object sender, EventArgs e) 
        { 
            sideBar.SelectedItem = sideBarItemMail; 
        } 
 
        private void menuItemContacts_Click(object sender, EventArgs e) 
        { 
            sideBar.SelectedItem = sideBarItemContacts; 
        } 
 
        private void menuItemTasks_Click(object sender, EventArgs e) 
        { 
            sideBar.SelectedItem = sideBarItemTasks; 
        } 
 
        private void menuItemNotes_Click(object sender, EventArgs e) 
        { 
            sideBar.SelectedItem = sideBarItemNotes; 
        } 
 
        private void sideBar_ItemSelected(object sender, ICreate.Controls.Bars.SideBarItemEventArgs args) 
        { 
            collapsingGroupPanel.HeaderText = sideBar.SelectedItem.Text; 
        } 
    } 
}
Visual BasicCopy Code
Public Class SelectedItemPropertyExample

    Private Sub MenuItemMail_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MenuItemMail.Click
        SideBar.SelectedItem = SideBarItemMail
    End Sub

    Private Sub MenuItemContacts_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MenuItemContacts.Click
        SideBar.SelectedItem = SideBarItemContacts
    End Sub

    Private Sub MenuItemTasks_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MenuItemTasks.Click
        SideBar.SelectedItem = SideBarItemTasks
    End Sub

    Private Sub MenuItemNotes_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MenuItemNotes.Click
        SideBar.SelectedItem = SideBarItemNotes
    End Sub

    Private Sub SideBar_ItemSelected(ByVal sender As System.Object, ByVal args As ICreate.Controls.Bars.SideBarItemEventArgs) Handles SideBar.ItemSelected
        CollapsingGroupPanel.HeaderText = SideBar.SelectedItem.Text
    End Sub
End Class

Remarks

To change the currently selected SideBarItem set SelectedItem to the selected SideBarItem. The SelectItem method can also be used to set the SelectedItem if you have the index, in the Items collection, of the SideBarItem to be selected.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also