RadMenu.Net2

Summary description for ControlBuilderForm.

Clean up any resources being used.

Required method for Designer support - do not modify the contents of this method with the code editor.

The Windows form that hosts the RadMenu editor.

Initializes a new instance of the RadMenuEventArgs class.

A RadMenuItem which represents an item in the RadMenu control.

Gets the referenced RadMenuItem in the RadMenu control when the event is raised.

The referenced item in the RadMenu control when the event is raised. Use this property to programmatically access the item referenced in the RadMenu when the event is raised.

A navigation control used to create collapsing interfaces.

The RadMenu control is used to display a list of items in a Web Forms page.The RadMenu control supports the following features: Databinding that allows the control to be populated from various datasources Programmatic access to the RadMenu object model which allows dynamic creation and customization of menus. Customizable appearance through built-in or user-defined skins.

Items

The RadMenu control is made up of tree of items represented by RadMenuItem objects. Items at the top level (level 0) are called root items. An item that has a parent item is called a child item. All root items are stored in the Items collection. Child items are stored in a parent item's Items collection. Each item has a Text, NavigateUrl, and a Value property. The value of the Text property is displayed in the RadMenu control, while the Value property is used to store any additional data about the item, such as data passed to the postback event associated with the item. When clicked, an item can navigate to another Web page indicated by the NavigateUrl property.

Gets the component's current version.

Gets or sets a value indicating whether to use the embedded JavaScript files or not.

True if embedded JavaScript files are to be used; otherwise false. The default value is true. Use this property for debugging purposes or to apply any modifications to the JavaScript files.

Defines properties that menu item containers (RadMenu, RadMenuItem) should implement

Gets the parent IMenuItemContainer.

Gets the collection of child items.

A RadMenuItemCollection that represents the child items. Use this property to retrieve the child items. You can also use it to programmatically add or remove items.

Initializes a new instance of the RadMenu class.

Use this constructor to create and initialize a new instance of the RadMenu control. The following example demonstrates how to programmatically create a RadMenu control.


            void Page_Load(object sender, EventArgs e)
            {
                RadMenu RadMenu1 = new RadMenu();
                RadMenu1.ID = "RadMenu1";
                
                RadMenuItem sportItem = new RadMenuItem("Sport", "~/Sport.aspx");
                RadMenu1.Items.Add(sportItem);
                
                RadMenuItem newsItem = new RadMenuItem("News");
                RadMenu1.Items.Add(newsItem);
             
                PlaceHolder1.Controls.Add(newsItem);
            }


            Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load
                Dim RadMenu1 As RadMenu = New RadMenu()
                RadMenu1.ID = "RadMenu1"
             
                Dim sportItem As RadMenuItem = New RadMenuItem("Sport", "")
                RadMenu1.Items.Add(sportItem)
             
                Dim newsItem As RadMenuItem = New RadMenuItem("News")
                RadMenu1.Items.Add(newsItem)
             
                PlaceHolder1.Controls.Add(newsItem)
            End Sub

Gets a linear list of all items in the RadMenu control.

An ArrayList containing all items (from all hierarchy levels). Use the GetAllItems method to obtain a linear collection of all items regardless their place in the hierarchy. The following example demonstrates how to disable all items within a RadMenu control.


            void Page_Load(object sender, EventArgs e)
            {
                foreach (RadMenuItem item in RadMenu1.GetAllItems())
                {
                    item.Enabled = false;
                }
            }


            Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load
                For Each childItem As RadMenuItem In RadMenu1.GetAllItems
                    childItem.Enabled = False
                Next
            End Sub

Searches the RadMenu control for the first Item with a NavigateUrl property equal to the specified value.

A Item whose NavigateUrl property is equal to the specified value. The method returns the first Item matching the search criteria. If no Item is matching then null (Nothing in VB.NET) is returned. The value to search for.

Searches the RadMenu control for the first RadMenuItem with a Text property equal to the specified value.

A RadMenuItem whose Text property is equal to the specified value. The method returns the first item matching the search criteria. If no item is matching then null (Nothing in VB.NET) is returned. The value to search for.

Searches the RadMenu control for the first RadMenuItem with a Value property equal to the specified value.

A RadMenuItem whose Value property is equal to the specified value. The method returns the first item matching the search criteria. If no item is matching then null (Nothing in VB.NET) is returned. The value to search for.

Populates the RadMenu control from external XML file. Added to support the legacy XML format used in previous versions.

The newly added items will be appended after any existing ones. The following example demonstrates how to populate RadMenu control from XML file.


            private void Page_Load(object sender, EventArgs e)
            {
                if (!Page.IsPostBack)
                {
                    RadMenu1.LoadContentFile("~/Menu/Examples/Menu.xml");
                }
            }


            Private Sub Page_Load(sender As Object, e As EventArgs) Handles MyBase.Load
                If Not Page.IsPostBack Then
                    RadMenu1.LoadContentFile("~/Menu/Examples/Menu.xml")
                End If
            End Sub

The name of the XML file.

Gets the RadMenu control structure as a XML string. Added to support the legacy XML format used in previous versions.

XML string which contains the whole RadMenu object along with its child items. The GetXmlString method gets all of the public properties of the RadMenu object and enumerates through all of them. If the current property is in the list of excluded properties ( These are properties which are not serialized. For example, Parent is such a property.) the process jumps to the next item. If the current value of the property that is being checked is different from the default value of that property, then this property will be serialized, and the new XML node attribute will be created for that property. After all of the RadMenu properties have been serialized, the GetXmlString method serializes all of the child items using the same algorithm

Note: This property is new in the .NET Framework version 2.0. Gets or sets the name of the validation group to which this validation control belongs.

The name of the validation group to which this validation control belongs. The default is an empty string (""), which indicates that this property is not set. This property works only when CausesValidation is set to true.

Gets or sets the URL of the page to post to from the current page when an item from the menu is clicked.

The URL of the Web page to post to from the current page when an item from the menu control is clicked. The default value is an empty string (""), which causes the page to post back to itself.

Gets the settings for the animation played when an item opens.

An AnnimationSettings that represents the expand animation. Use the ExpandAnimation property to customize the expand animation of RadMenu. You can specify the Type, Duration and the To disable expand animation effects you should set the Type to AnimationType.None.
To customize the collapse animation you can use the CollapseAnimation property. The following example demonstrates how to set the ExpandAnimation of RadMenu. ASPX: <radM:RadMenu ID="RadMenu1" runat="server"> <ExpandAnimation Type="OutQuint" Duration="300" /> <Items> <radM:RadMenuItem Text="News" > <Items> <radM:RadMenuItem Text="CNN" NavigateUrl="http://www.cnn.com" /> <radM:RadMenuItem Text="Google News" NavigateUrl="http://news.google.com" /> </Items> </radM:RadMenuItem> <radM:RadMenuItem Text="Sport" > <Items> <radM:RadMenuItem Text="ESPN" NavigateUrl="http://www.espn.com" /> <radM:RadMenuItem Text="Eurosport" NavigateUrl="http://www.eurosport.com" /> </Items> </radM:RadMenuItem> </Items> </radM:RadMenu>


            void Page_Load(object sender, EventArgs e)
            {
                RadMenu1.ExpandAnimation.Type = AnimationType.Linear;
                RadMenu1.ExpandAnimation.Duration = 300;
            }


            Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load
                RadMenu1.ExpandAnimation.Type = AnimationType.Linear
                RadMenu1.ExpandAnimation.Duration = 300
            End Sub

Gets or sets a value indicating whether the menu is context or not.

Specifies the default settings for child item behavior.

An instance of the MenuItemGroupSettings class. You can customize the following settings item flow expand direction horizontal offset from the parent item vertical offset from the parent item width height For more information check MenuItemGroupSettings.

Gets or sets a value indicating if an automatic scroll is applied if the groups are larger then the screen height.

Gets or sets a value indicating whether the screen boundary detection will be applied when expanded.

Gets or sets the ID of the html element which if right-clicked will display the context menu.

If the ID is empty the menu will appear on right-clicking anywhere on the page. In popup scenarios, where you show the menu programmatically, you can set the ContextMenuElementID property to some nonexisting value e.g. "None".

Gets or sets a value indicating whether root items should open on mouse click.

True if the root items open on mouse click; otherwise false. The default value is false. Use the ClickToOpen property to customize the way root menu items are opened. By default menu items are opened on mouse hovering.

Gets the settings for the animation played when an item closes.

An AnnimationSettings that represents the collapse animation. Use the CollapseAnimation property to customize the expand animation of RadMenu. You can specify the Type, Duration and the items are collapsed.
To disable expand animation effects you should set the Type to AnimationType.None. To customize the expand animation you can use the ExpandAnimation property. The following example demonstrates how to set the CollapseAnimation of RadMenu. ASPX: <radM:RadMenu ID="RadMenu1" runat="server"> <CollapseAnimation Type="OutQuint" Duration="300" /> <Items> <radM:RadMenuItem Text="News" > <Items> <radM:RadMenuItem Text="CNN" NavigateUrl="http://www.cnn.com" /> <radM:RadMenuItem Text="Google News" NavigateUrl="http://news.google.com" /> </Items> </radM:RadMenuItem> <radM:RadMenuItem Text="Sport" > <Items> <radM:RadMenuItem Text="ESPN" NavigateUrl="http://www.espn.com" /> <radM:RadMenuItem Text="Eurosport" NavigateUrl="http://www.eurosport.com" /> </Items> </radM:RadMenuItem> </Items> </radM:RadMenu>


            void Page_Load(object sender, EventArgs e)
            {
                RadMenu1.CollapseAnimation.Type = AnimationType.Linear;
                RadMenu1.CollapseAnimation.Duration = 300;
            }


            Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load
                RadMenu1.CollapseAnimation.Type = AnimationType.Linear
                RadMenu1.CollapseAnimation.Duration = 300
            End Sub

Gets or sets the template for displaying the items in RadMenu.

A ITemplate implemented object that contains the template for displaying menu items. The default value is a null reference (Nothing in Visual Basic), which indicates that this property is not set. The ItemTemplate property sets a template that will be used for all menu items. To specify unique display for individual items use the ItemTemplate property of the RadMenuItem class. The following example demonstrates how to use the ItemTemplate property to add a CheckBox for each item. ASPX: <radM:RadMenu runat="server" ID="RadMenu1">

<ItemTemplate>
<asp:CheckBox runat="server" ID="CheckBox"></asp:CheckBox>
<asp:Label runat="server" ID="Label1"
Text='<%# DataBinder.Eval(Container, "Text") %>' ></asp:Label>

</ItemTemplate> <Items>
<radM:RadMenuItem Text="News" /> <radM:RadMenuItem Text="Sports" /> <radM:RadMenuItem Text="Games" />
</Items>

</radM:RadMenu>

Gets or sets the relative path of the folder containing the skins.

If the skin folder is located in the project root and is named "Skins" the SkinsPath property should be set to: "~/Skins". Then you can create subfolders for individual skins e.g. Skins/Gold, Skins/Default etc. A string specifying the relative path to the folder which contains RadMenu skins. The default value is "~/RadControls/Menu/Skins". RadMenu ships with a set of predefined skins which are ready to use. They are located in RadControls/Menu/Skins.

Gets or sets the skin used by RadMenu.

A String specifying the skin. The default value is empty string (""). If the value is empty string ("") no skin is used.

Gets or sets a value indicating whether validation is performed when an item within the RadMenu control is selected.

true if validation is performed when an item is selected; otherwise, false. The default value is true. By default, page validation is performed when an item is selected. Page validation determines whether the input controls associated with a validation control on the page all pass the validation rules specified by the validation control. You can specify or determine whether validation is performed on both the client and the server when an item is clicked by using the CausesValidation property. To prevent validation from being performed, set the CausesValidation property to false.

Gets or sets a value indicating the timeout after which a menu item starts to open.

An integer specifying the timeout measured in milliseconds. The default value is 0 which means that menu items open immediately. Use the ExpandDelay property to delay item opening. To customize the timeout prior to item closing use the CollapseDelay property. The following example demonstrates how to specify a half second (500 milliseconds) timeout prior to item opening: ASPX: <radM:RadMenu ID="RadMenu1" runat="server" ExpandDelay="500" />

Gets or sets a value indicating the way top level items will flow.

One of the ItemFlow values. The default value for top level items is Horizontal. Use the Flow property to customize the way top level items are displayed. If set to Horizontal items are positioned one after another. Vertical causes the items to flow one below the other. The following example demonstrates how to make a vertical menu. ASPX: <radM:RadMenu ID="RadMenu1" runat="server" Flow="Vertical" />

Gets or sets a value indicating the timeout after which a menu item starts to close.

An integer specifying the timeout measured in milliseconds. The default value is 500 (half a second). Use the CollapseDelay property to delay item closing. To cause immediate item closing set this property to 0 (zero). To customize the timeout prior to item closing use the ExpandDelay property. The following example demonstrates how to specify one second (1000 milliseconds) timeout prior to item closing: ASPX: <radM:RadMenu ID="RadMenu1" runat="server" ClosingDelay="1000" />

The DataSource object used for data-binding. Can be either IListSource (DataSet, DataTable, DataView) or ICollection / IEnumerable (ArrayList, arrays, etc)

Gets or sets the object from which the data-bound control retrieves its list of data items.

RadMenu fully supports binding to IList datasources (DataSet, DataTable) and ICollection / IEnumerable (ArrayList, arrays, etc), so you can easily populate your menu instance with only a few lines of code. The built-in data binding supports auto-binding from a a single self-referencing table with ID -> ParentID relation.

Properties and methods related to data binding: DataSource - (mandatory) object. Set to an instance of your datasource. DataMember - (optional) string. If the DataSource is a DataSet and DataMember is set, then RadMenu assumes the DataTable with the respective name in the DataSet. Otherwise the first DataTable in the DataSet is used. DataFieldID - (optional) string. The name of the DataColumn holding the ID value; DataFieldParentID - (optional) string. The name of the DataColumn holding the ParentID value; DataTextField (optional) - Gets or sets the field name from a data source to bind to the MenuItem Text property. DataValueField (optional) - Gets or sets the field name from a data source to bind to the MenuItem Value property. DataNavigateUrlField (optional) - Gets or set the field name from a data source to bind to the MenuItem NavigageUrl property. DataBind() - (mandatory) method. Call this method after you've set the aforementioned properties per your scenario.


            Dim dbCon As New OleDbConnection("Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + Server.MapPath("~/data.mdb"))
            dbCon.Open()
             
            Dim adapter As New OleDbDataAdapter("SELECT * FROM Links", dbCon)
            Dim ds As New DataSet()
            adapter.Fill(ds)
             
            RadMenu1.DataTextField = "TextColumn"
            RadMenu1.DataValueField = "ValueColumn"
            RadMenu1.DataFieldID = "ID"
            RadMenu1.DataFieldParentID = "ParentID"
             
            RadMenu1.DataSource = ds
            RadMenu1.DataBind()


            OleDbConnection dbCon = new OleDbConnection ("Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + Server.MapPath("~/data.mdb"));
            dbCon.Open();
             
            OleDbDataAdapter adapter = new OleDbDataAdapter("SELECT * FROM Links", dbCon);
            DataSet ds = new DataSet();
            adapter.Fill(ds);
             
            RadMenu1.DataTextField = "TextColumn"
            RadMenu1.DataValueField = "ValueColumn"
            RadMenu1.DataFieldID = "ID";
            RadMenu1.DataFieldParentID = "ParentID";
             
            RadMenu1.DataSource = ds;            
            RadMenu1.DataBind();

A data source that provides data for populating the RadMenu control.

Gets or sets the field from the data source that provides values for the Text property of the items.

A string that specifies the field from the data source that provides values for the Text property of the items. The default value is empty string.


            Dim dbCon As New OleDbConnection("Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + Server.MapPath("~/menu/Data/Tree.mdb"))
            dbCon.Open()
             
            Dim adapter As New OleDbDataAdapter("SELECT * FROM Links", dbCon)
            Dim ds As New DataSet()
            adapter.Fill(ds)
             
            RadMenu1.DataTextField = "TextColumn"
            RadMenu1.DataValueField = "ValueColumn"
            RadMenu1.DataFieldID = "ID"
            RadMenu1.DataFieldParentID = "ParentID"
            RadMenu1.DataNavigateUrlField = "URL"
             
            RadMenu1.DataSource = ds
            RadMenu1.DataBind()


            OleDbConnection dbCon = new OleDbConnection ("Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + Server.MapPath("~/menu/Data/Tree.mdb"));
            dbCon.Open();
             
            OleDbDataAdapter adapter = new OleDbDataAdapter("SELECT * FROM Links", dbCon);
            DataSet ds = new DataSet();
            adapter.Fill(ds);
             
            RadMenu1.DataTextField = "TextColumn"
            RadMenu1.DataValueField = "ValueColumn"
            RadMenu1.DataFieldID = "ID";
            RadMenu1.DataFieldParentID = "ParentID";
            RadMenu1.DataNavigateUrlField = "URL";
             
            RadMenu1.DataSource = ds;            
            RadMenu1.DataBind();


            Dim dbCon As New OleDbConnection("Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + Server.MapPath("~/menu/Data/Tree.mdb"))
            dbCon.Open()
             
            Dim adapter As New OleDbDataAdapter("SELECT * FROM Links", dbCon)
            Dim ds As New DataSet()
            adapter.Fill(ds)
             
            RadMenu1.DataTextField = "TextColumn"
            RadMenu1.DataValueField = "ValueColumn"
            RadMenu1.DataFieldID = "ID"
            RadMenu1.DataFieldParentID = "ParentID"
            RadMenu1.DataNavigateUrlField = "URL"
             
            RadMenu1.DataSource = ds
            RadMenu1.DataBind()


            OleDbConnection dbCon = new OleDbConnection ("Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + Server.MapPath("~/menu/Data/Tree.mdb"));
            dbCon.Open();
             
            OleDbDataAdapter adapter = new OleDbDataAdapter("SELECT * FROM Links", dbCon);
            DataSet ds = new DataSet();
            adapter.Fill(ds);
             
            RadMenu1.DataTextField = "TextColumn"
            RadMenu1.DataValueField = "ValueColumn"
            RadMenu1.DataFieldID = "ID";
            RadMenu1.DataFieldParentID = "ParentID";
            RadMenu1.DataNavigateUrlField = "URL";
             
            RadMenu1.DataSource = ds;            
            RadMenu1.DataBind();

Gets or sets the field from the data source that provides values for the NavigateUrl property of the items.

A string that specifies the the field from the data source that provides values for the NavigateUrl property of the items. The default value is empty string.


            Dim dbCon As New OleDbConnection("Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + Server.MapPath("~/menu/Data/Tree.mdb"))
            dbCon.Open()
             
            Dim adapter As New OleDbDataAdapter("SELECT * FROM Links", dbCon)
            Dim ds As New DataSet()
            adapter.Fill(ds)
             
            RadMenu1.DataTextField = "TextColumn"
            RadMenu1.DataValueField = "ValueColumn"
            RadMenu1.DataFieldID = "ID"
            RadMenu1.DataFieldParentID = "ParentID"
            RadMenu1.DataNavigateUrlField = "URL"
             
            RadMenu1.DataSource = ds
            RadMenu1.DataBind()


            OleDbConnection dbCon = new OleDbConnection ("Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + Server.MapPath("~/menu/Data/Tree.mdb"));
            dbCon.Open();
             
            OleDbDataAdapter adapter = new OleDbDataAdapter("SELECT * FROM Links", dbCon);
            DataSet ds = new DataSet();
            adapter.Fill(ds);
             
            RadMenu1.DataTextField = "TextColumn"
            RadMenu1.DataValueField = "ValueColumn"
            RadMenu1.DataFieldID = "ID";
            RadMenu1.DataFieldParentID = "ParentID";
            RadMenu1.DataNavigateUrlField = "URL";
             
            RadMenu1.DataSource = ds;            
            RadMenu1.DataBind();

Gets or sets the field from the data source that provides values for the Value property of the items.

A string that specifies the field from the data source that provides values for the Value property of the items. The default is empty string.


            Dim dbCon As New OleDbConnection("Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + Server.MapPath("~/menu/Data/Tree.mdb"))
            dbCon.Open()
             
            Dim adapter As New OleDbDataAdapter("SELECT * FROM Links", dbCon)
            Dim ds As New DataSet()
            adapter.Fill(ds)
             
            RadMenu1.DataTextField = "TextColumn"
            RadMenu1.DataValueField = "ValueColumn"
            RadMenu1.DataFieldID = "ID"
            RadMenu1.DataFieldParentID = "ParentID"
            RadMenu1.DataNavigateUrlField = "URL"
             
            RadMenu1.DataSource = ds
            RadMenu1.DataBind()


            OleDbConnection dbCon = new OleDbConnection ("Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + Server.MapPath("~/menu/Data/Tree.mdb"));
            dbCon.Open();
             
            OleDbDataAdapter adapter = new OleDbDataAdapter("SELECT * FROM Links", dbCon);
            DataSet ds = new DataSet();
            adapter.Fill(ds);
             
            RadMenu1.DataTextField = "TextColumn"
            RadMenu1.DataValueField = "ValueColumn"
            RadMenu1.DataFieldID = "ID";
            RadMenu1.DataFieldParentID = "ParentID";
            RadMenu1.DataNavigateUrlField = "URL";
             
            RadMenu1.DataSource = ds;            
            RadMenu1.DataBind();

Gets or sets the formatting string used to control how the item text would look like.

Use the DataTextFormatString property to provide a custom display format for text of the items. The data format string consists of two parts, separated by a colon, in the form { A: Bxx }. For example, the formatting string {0:F2} would format the text as a fixed point number with two decimal places. Note the entire string must be enclosed in braces to indicate that it is a format string and not a literal string. Any text outside the braces is displayed as literal text. The value before the colon (A in the general example) specifies the parameter index in a zero-based list of parameters. A string value representing the format of the Text property.

Gets or sets a value indicating the client-side event handler that is called when the mouse moves over a menu item in the RadMenu control.

A string specifying the name of the JavaScript function that will handle the event. The default value is empty string. If specified, the OnClientMouseOver client-side event handler is called when the mouse moves over a menu item. Two parameters are passed to the handler: sender, the menu client object; eventArgs with one property, Item (the instance of the menu item). This event cannot be cancelled. The following example demonstrates how to use the OnClientMouseOver property.

<radM:RadMenu ID="RadMenu1"
runat= "server"
OnClientMouseOver= "OnClientMouseOverHandler">
....
</radM:RadMenu>

If specified, the OnClientMouseOut client-side event handler is called when the mouse moves out of a menu item. Two parameters are passed to the handler: sender, the menu client object; eventArgs with one property, Item (the instance of the menu item). This event cannot be cancelled.

Gets or sets a value indicating the client-side event handler that is called when the mouse moves out of a menu item in the RadMenu control.

A string specifying the name of the JavaScript function that will handle the event. The default value is empty string. <script type="text/javascript">
function OnClientMouseOutHandler(sender, eventArgs)
{
alert(eventArgs.Item.Text);
}
</script> <radM:RadMenu ID="RadMenu1"
runat= "server"
OnClientMouseOut= "OnClientMouseOutHandler">
....
</radM:RadMenu>

Gets or sets a value indicating the client-side event handler that is called when a menu item gets focus.

A string specifying the name of the JavaScript function that will handle the event. The default value is empty string. <script type="text/javascript">
function OnClientItemFocusHandler(sender, eventArgs)
{
alert(eventArgs.Item.Text);
}
</script> <radM:RadMenu ID="RadMenu1"
runat="server"
OnClientItemFocus="OnClientItemFocusHandler">
....
</radM:RadMenu> If specified, the OnClientItemFocus client-side event handler is called when a menu item is selected using either the keyboard (the [TAB] or arrow keys) or by clicking it. Two parameters are passed to the handler: sender, the menu client object; eventArgs with one property, Item (the instance of the menu item). This event cannot be cancelled.

Gets or sets a value indicating the client-side event handler that is called after an item loses focus.

A string specifying the name of the JavaScript function that will handle the event. The default value is empty string. If specified, the OnClientItemBlur client-side event handler is called when a menu item loses focus as a result of the user pressing a key or clicking elsewhere on the page. Two parameters are passed to the handler: sender, the menu client object; eventArgs with one property, Item (the instance of the menu item). This event cannot be cancelled. <script type="text/javascript">
function OnClientItemBlurHandler(sender, eventArgs)
{
alert(eventArgs.Item.Text);
}
</script> <radM:RadMenu ID="RadMenu1"
runat="server"
OnClientItemBlur="OnClientItemBlurHandler">
....
</radM:RadMenu> This event is similar to OnClientItemFocus but fires only on mouse click. If specified, the OnClientItemClicking client-side event handler is called before a menu item is clicked upon. Two parameters are passed to the handler: sender, the menu client object; eventArgs with one property, Item (the instance of the menu item). The OnClientItemClicking event can be cancelled. To do so, return False from the event handler.

Gets or sets a value indicating the client-side event handler that is called when a menu item is clicked.

Gets or sets a value indicating the client-side event handler that is called after a menu item is clicked.

This event is similar to OnClientItemFocus but fires only on mouse click. If specified, the OnClientItemClicked client-side event handler is called after a menu item is clicked upon. Two parameters are passed to the handler: sender, the menu client object; eventArgs with one property, Item (the instance of the menu item). This event cannot be cancelled. <script type="text/javascript">
function OnClientItemClickedHandler(sender, eventArgs)
{
alert(eventArgs.Item.Text);
}
</script>
<radM:RadMenu ID="RadMenu1"
runat="server"
OnClientItemClicked="OnClientItemClickedHandler">
....
</radM:RadMenu> A string specifying the name of the JavaScript function that will handle the event. The default value is empty string.

Gets or sets a value indicating the client-side event handler that is called when a group of child items opens.

A string specifying the name of the JavaScript function that will handle the event. The default value is empty string. If specified, the OnClientItemOpen client-side event handler is called when a group of child items opens. Two parameters are passed to the handler: sender, the menu client object; eventArgs with one property, Item (the instance of the menu item). This event cannot be cancelled. <script type="text/javascript">
function OnClientItemOpenHandler(sender, eventArgs)
{
alert(eventArgs.Item.Text);
}
</script> <radM:RadMenu ID="RadMenu1"
runat="server"
OnClientItemOpen="OnClientItemOpenHandler">
....
</radM:RadMenu>

Gets or sets a value indicating the client-side event handler that is called when a group of child items closes.

A string specifying the name of the JavaScript function that will handle the event. The default value is empty string. <script type="text/javascript">
function OnClientItemCloseHandler(sender, eventArgs)
{
alert(eventArgs.Item.Text);
}
</script> <radM:RadMenu ID="RadMenu1"
runat="server"
OnClientItemClose="OnClientItemCloseHandler">
....
</radM:RadMenu> If specified, the OnClientItemClose client-side event handler is called when a group of child items closes. Two parameters are passed to the handler: sender, the menu client object; eventArgs with one property, Item (the instance of the menu item). This event cannot be cancelled. If specified, the OnClienLoad client-side event handler is called after the menu is fully initialized on the client. A single parameter - the menu client object - is passed to the handler. This event cannot be cancelled. <script type="text/javascript">
function OnClientLoadHandler(sender)
{
alert(sender.ID);
}
</script> <radM:RadMenu ID="RadMenu1"
runat= "server"
OnClientLoad= "OnClientLoadHandler">
....
</radM:RadMenu> A string specifying the name of the JavaScript function that will handle the event. The default value is empty string.

Gets or sets a value indicating the client-side event handler that is called after the RadMenu client-side object is initialized.

If specified, the OnClientContextShowing client-side event handler is called before the context menu is shown on the client. A single parameter - the menu client object - is passed to the handler. The OnClientContextShowing event can be cancelled. To do so, return false from the event handler. <script type="text/javascript">
function OnClientContextShowingHandler(sender)
{
alert(sender.ID);
}
</script> <radM:RadMenu ID="RadMenu1"
runat= "server"
OnClientContextShowing= "OnClientContextShowingHandler">
....
</radM:RadMenu> A string specifying the name of the JavaScript function that will handle the event. The default value is empty string.

Gets or sets a value indicating the client-side event handler that is called before the RadMenu client-side object is shown.

If specified, the OnClientContextShown client-side event handler is called after the context menu is shown on the client. A single parameter - the menu client object - is passed to the handler. This event cannot be cancelled. <script type="text/javascript">
function OnClientContextShownHandler(sender)
{
alert(sender.ID);
}
</script> <radM:RadMenu ID="RadMenu1"
runat= "server"
OnClientContextShown="OnClientContextShownHandler">
....
</radM:RadMenu> A string specifying the name of the JavaScript function that will handle the event. The default value is empty string.

Gets or sets a value indicating the client-side event handler that is called after the RadMenu client-side object is shown.

If specified, the OnClientContextHidden client-side event handler is called after the context menu is hidden on the client. A single parameter - the menu client object - is passed to the handler. This event cannot be cancelled. <script type="text/javascript">
function OnClientContextHiddenHandler(sender)
{
alert(sender.ID);
}
</script> <radM:RadMenu ID="RadMenu1"
runat= "server"
OnClientContextHidden="OnClientContextHiddenHandler">
....
</radM:RadMenu> A string specifying the name of the JavaScript function that will handle the event. The default value is empty string.

Gets or sets a value indicating the client-side event handler that is called after the RadMenu client-side object is hidden.


            Dim dbCon As New OleDbConnection("Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + Server.MapPath("~/menu/Data/Tree.mdb"))
            dbCon.Open()
             
            Dim adapter As New OleDbDataAdapter("SELECT * FROM Links", dbCon)
            Dim ds As New DataSet()
            adapter.Fill(ds)
             
            RadMenu1.DataTextField = "TextColumn"
            RadMenu1.DataValueField = "ValueColumn"
            RadMenu1.DataFieldID = "ID"
            RadMenu1.DataFieldParentID = "ParentID"
            RadMenu1.DataNavigateUrlField = "URL"
             
            RadMenu1.DataSource = ds
            RadMenu1.DataBind()


            OleDbConnection dbCon = new OleDbConnection ("Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + Server.MapPath("~/menu/Data/Tree.mdb"));
            dbCon.Open();
             
            OleDbDataAdapter adapter = new OleDbDataAdapter("SELECT * FROM Links", dbCon);
            DataSet ds = new DataSet();
            adapter.Fill(ds);
             
            RadMenu1.DataTextField = "TextColumn"
            RadMenu1.DataValueField = "ValueColumn"
            RadMenu1.DataFieldID = "ID";
            RadMenu1.DataFieldParentID = "ParentID";
            RadMenu1.DataNavigateUrlField = "URL";
             
            RadMenu1.DataSource = ds;            
            RadMenu1.DataBind();

Gets or sets the field from the data source which is the "child" column in the "parent-child" relationship used to databind the RadMenu control.

A string that specifies the field of the data source that will be the "child" column during databinding. The default is empty string RadMenu requires both DataFieldID and DataFieldParentID properties to be set in order to be databound recursively.


            Dim dbCon As New OleDbConnection("Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + Server.MapPath("~/menu/Data/Tree.mdb"))
            dbCon.Open()
             
            Dim adapter As New OleDbDataAdapter("SELECT * FROM Links", dbCon)
            Dim ds As New DataSet()
            adapter.Fill(ds)
             
            RadMenu1.DataTextField = "TextColumn"
            RadMenu1.DataValueField = "ValueColumn"
            RadMenu1.DataFieldID = "ID"
            RadMenu1.DataFieldParentID = "ParentID"
            RadMenu1.DataNavigateUrlField = "URL"
             
            RadMenu1.DataSource = ds
            RadMenu1.DataBind()


            OleDbConnection dbCon = new OleDbConnection ("Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" + Server.MapPath("~/menu/Data/Tree.mdb"));
            dbCon.Open();
             
            OleDbDataAdapter adapter = new OleDbDataAdapter("SELECT * FROM Links", dbCon);
            DataSet ds = new DataSet();
            adapter.Fill(ds);
             
            RadMenu1.DataTextField = "TextColumn"
            RadMenu1.DataValueField = "ValueColumn"
            RadMenu1.DataFieldID = "ID";
            RadMenu1.DataFieldParentID = "ParentID";
            RadMenu1.DataNavigateUrlField = "URL";
             
            RadMenu1.DataSource = ds;            
            RadMenu1.DataBind();

Gets or sets the field from the data source which is the "parent" column in the "parent-child" relationship used to databind the RadMenu control.

A string that specifies the field of the data source that will be the "parent" column during databinding. The default is empty string. RadMenu requires both DataFieldID and DataFieldParentID properties to be set in order to be databound recursively.

Gets or sets a value that indicates whether the items are cleared before data binding.

True if items should not be cleared before data binding; otherwise false. The default value is false (child items are cleared). The AppendDataBoundItems property allows you to add items to the RadMenu control before data binding occurs. After data binding, the items collection contains both the items from the data source and the previously added items.

Occurs on the server when an item in the RadMenu control is created.

The ItemCreated event is raised every time a new item is added. The ItemCreated event is not related to data binding and you cannot retrieve the DataItem of the item in the event handler. The ItemCreated event is often useful in scenarios where you want to initialize all items - for example setting the ToolTip of each RadMenuItem to be equal to the Text property. The following example demonstrates how to use the ItemCreated event to set the ToolTip property of each item.


            private void RadMenu1_ItemCreated(object sender, Telerik.WebControls.RadMenuItemEventArgs e)
            {
                e.Item.ToolTip = e.Item.Text;
            }


            Sub RadMenu1_ItemCreated(ByVal sender As Object, ByVal e As Telerik.WebControls.RadMenuItemEventArgs) Handles RadMenu1.ItemCreated
                e.Item.ToolTip = e.Item.Text
            End Sub

Occurs on the server when a menu item in the RadMenu control is clicked.

The menu will also postback if you navigate to a menu item using the [menu item] key and then press [enter] on the menu item that is focused. The instance of the clicked menu item is passed to the MenuItemClick event handler - you can obtain a reference to it using the eventArgs.RadMenuItem property.

Occurs after a menu item is data bound.

The ItemDataBound event is raised for each menu item upon databinding. You can retrieve the item being bound using the event arguments. The DataItem associated with the item can be retrieved using the DataItem property. The ItemDataBound event is often used in scenarios when you want to perform additional mapping of fields from the DataItem to their respective properties in the RadMenuItem class. The following example demonstrates how to map fields from the data item to item properties using the ItemDataBound event.


            private void RadMenu1_ItemDataBound(object sender, Telerik.WebControls.RadMenuEventArgs e)
            {
                RadMenuItem item = e.RadMenuItem;
                DataRowView dataRow = (DataRowView) e.Item.DataItem;
             
                item.ImageUrl = "image" + dataRow["ID"].ToString() + ".gif";
                item.NavigateUrl = dataRow["URL"].ToString();
            }


            Sub RadMenu1_ItemDataBound(ByVal sender As Object, ByVal e As RadMenuEventArgs) Handles RadMenu1.ItemDataBound
                Dim item As RadMenuItem = e.RadMenuItem
                Dim dataRow As DataRowView = CType(e.Item.DataItem, DataRowView)
             
                item.ImageUrl = "image" + dataRow("ID").ToString() + ".gif"
                item.NavigateUrl = dataRow("URL").ToString()
            End Sub

Gets the collection of child items in the RadMenu control.

A RadMenuItemCollection that represents the children within the RadMenu control. The default is empty collection. Use this property to retrieve the child items of the RadMenu control. You can also use it to programmatically add or remove items. The following example demonstrates how to programmatically add items.


            void Page_Load(object sender, EventArgs e)
            {
                if (!Page.IsPostBack)
                {
                    RadMenuItem corporateItem = new RadMenuItem("Corporate");
                    RadMenu1.Items.Add(corporateItem);
             
                    RadMenuItem newsItem = new RadMenuItem("News");
                    RadMenu1.Items.Add(newsItem);
                
                    RadMenuItem aboutUsItem = new RadMenuItem("About us");
                    RadMenu1.Items.Add(aboutUsItem);
                }
            }


            Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load
                If Not Page.IsPostBack Then
                    Dim corporateItem As RadMenuItem = New RadMenuItem("Corporate")
                    RadMenu1.Items.Add(newsItem)
             
                    Dim newsItem As RadMenuItem = New RadMenuItem("News")
                    RadMenu1.Items.Add(newsItem)
             
                    Dim aboutUsItem As RadMenuItem = New RadMenuItem("About us")
                    RadMenu1.Items.Add(aboutUsItem)
                End If
            End Sub

Gets or sets the data member to bind to a menu item.

When creating a RadMenuItemBinding object, you must specify the criteria for binding. The criteria indicate when a data item should be bound to a menu item. You can specify the Depth property, the DataMember property, or both. When the data source contains multiple elements or tables, use the DataMember property to specify the element or table to bind to a menu item. A data member specifies the type of the data item in the underlying data source, but can represent different information depending on the data source. Each data item in a hierarchical data source exposes a IHierarchyData.Type property, which specifies the type of the data item. For example, the data member for an XML element specifies the name of the element. The following RadMenuItemBinding declaration binds the


            			<Book>

elements of an XmlDataSource control to all the menu items in the menu, regardless of the location in the hierarchy:

            <asp:RadMenuItemBinding DataMember="Book" TextField="Title" ValueField= "ISBN">


            			<Item>

elements that appear at different levels within an XML file. The following RadMenuItemBinding declarations show how to specify menu item bindings that apply to identical data members at different menu depths:


            			<asp:RadMenuItemBinding DataMember="Item" Depth="1" TextField="Title">


            			<asp:RadMenuItemBinding DataMember="Item" Depth="2" TextField="ISBN">

If a menu item binding is defined without a depth or a data member, the menu item binding is applied to all menu items within the menu. This is commonly used when all data items have the same properties and should be displayed identically, regardless of the menu depth. After the binding criteria are established, you can then bind a property of a RadMenuItem object that can be bound to a value. You can bind to a field of a data item or to a static value. When bound to a static value, all RadMenuItem objects to which the RadMenuItemBinding object is applied share the same value. Properties bound to fields contain the values of the field from the data source. If conflicting RadMenuItemBinding objects are defined, the Menu control applies the menu item bindings in the following order of precedence: The RadMenuItemBinding object that defines and matches both a depth and a data member. The RadMenuItemBinding object that defines and matches the data member only. The RadMenuItemBinding object that defines and matches the depth only. The RadMenuItemBinding object that defines neither the depth nor the data member. (This type of menu item binding is applied to all menu items in the menu.) The RadMenuItemBinding object that does not have a match in the data source. In this case, the value returned by the ToString() method of the data item is then bound to the Text and Value properties of the menu items to which the RadMenuItemBinding object is applied.

Gets or sets the text caption for the item.

The text of the item. The default value is empty string. This example demonstrates how to set the text of the item using the Text property. <radM:RadMenu ID="RadMenu1" runat="server">
<Items>
<radM:RadMenuItem Text="News" />
<radM:RadMenuItem Text="News" />
</Items>
</radM:RadMenu> Specifying Text or TextField will override the values populated from the DataTextField property.

Gets or sets the name of the field from the data source to bind to the Text property of a RadMenuItem object to which the RadMenuItemBinding object is applied.

The name of the field from the data source to bind to the Text of a RadMenuItem to which the RadMenuItemBinding is applied. The default is an empty string (""), which indicates that this property is not set. Specifying Text or TextField will override the values populated from the DataTextField property.

Gets or sets the value associated with the item.

The value associated with the item. The default value is empty string. Use the Value property to specify or determine the value associated with the item. Specifying Value or ValueField will override the values populated from the DataValueField property.

Gets or sets the name of the field from the data source to bind to the Value property of a RadMenuItem object to which the RadMenuItemBinding object is applied.

The name of the field from the data source to bind to the Value of a RadMenuItem to which the RadMenuItemBinding is applied. The default is an empty string (""), which indicates that this property is not set. Specifying Value or ValueField will override the values populated from the DataValueField property.

Gets or sets the URL to link to when the item is clicked.

The URL to link to when the item is clicked. The default value is empty string. The following example demonstrates how to use the NavigateUrl property <radM:RadMenu id="RadMenu1" runat="server">
<Items>
<radM:RadMenuItem Text="News" NavigateUrl="~/News.aspx" />
<radM:RadMenuItem Text="External URL" NavigateUrl="http://www.example.com" />
</Items>
</radM:RadMenu> Use the NavigateUrl property to specify the URL to link to when the item is clicked. Use "~" (tilde) in front of an URL within the same ASP.NET application. When specifying external URL do not forget the protocol (e.g. "http://"). Specifying NavigateUrl or NavigateUrlField will override the values populated from the DataNavigateUrlField property.

Gets or sets the name of the field from the data source to bind to the NavigateUrl property of a RadMenuItem object to which the RadMenuItemBinding object is applied.

The name of the field from the data source to bind to the NavigateUrl of a RadMenuItem to which the RadMenuItemBinding is applied. The default is an empty string (""), which indicates that this property is not set. Specifying %NavigateUrl:NavigateUrl% or NavigateUrlField will override the values populated from the DataNavigateUrlField property.

Gets or sets the ToolTip text for a menu item to which the RadMenuItemBinding object is applied.

The ToolTip text for a menu item to which the RadMenuItemBinding is applied. The default is an empty string (""), which indicates that this property is not set.

Gets or sets the name of the field from the data source to bind to the ToolTip property of a RadMenuItem object to which the RadMenuItemBinding object is applied.

The name of the field from the data source to bind to the ToolTip of a RadMenuItem to which the RadMenuItemBinding is applied. The default is an empty string (""), which indicates that this property is not set.

Gets or sets the URL to an image that is displayed next to the text of a menu item to which the RadMenuItemBinding object is applied.

The URL to an image that is displayed next to the text of a menu item to which the RadMenuItemBinding is applied. The default is an empty string (""), which indicates that this property is not set. This image is shared with all RadMenuItem objects to which the RadMenuItemBinding object is applied. NOTE: You can override the image for an individual menu item by setting its ImageUrl property directly. Instead of using this property to display the same image in each menu item, you can also use the ImageUrlField property to bind the ImageUrl property of a RadMenuItem object to a field of a data source. When rendered, the ImageUrl property of each menu item to which the RadMenuItemBinding object is applied contains the corresponding value from the field. NOTE: If the ImageUrl and ImageUrlField properties are both set, the ImageUrlField property takes precedence. You can override the image for an individual menu item by setting its ImageUrl property directly.

Gets or sets the name of the field from the data source to bind to the ImageUrl property of a RadMenuItem object to which the RadMenuItemBinding object is applied.

The name of the field from the data source to bind to the ImageUrl of a RadMenuItem to which the RadMenuItemBinding is applied. The default is an empty string (""), which indicates that this property is not set. If the data source contains multiple tables or attributes, you must first establish the binding criteria by setting the Depth property, the DataMember property, or both. Instead of using this property to bind the ImageUrl property of a RadMenuItem object to a field, you can also bind it to a static value by setting the RadMenuItemBinding.ImageUrl property. This allows you to display the same image in each menu item to which the RadMenuItemBinding object is applied. NOTE: If the ImageUrl and ImageUrlField properties are both set, the ImageUrlField property takes precedence.

Gets or sets the path to an image to display for the item when the user moves the mouse over the item.

The path to the image to display when the user moves the mouse over the item. The default value is empty string. <radm:RadMenu id="RadMenu1" runat="server">
<Items>
<radm:RadMenuItem ImageUrl="~/Img/inbox.gif" ImageOverUrl="~/Img/inboxOver.gif" Text="Index" />
<radm:RadMenuItem ImageUrl="~/Img/outbox.gif" ImageOverUrl="~/Img/outboxOver.gif" Text="Outbox" />
</Items>
</radm:RadMenu> Use the ImageOverUrl property to specify the image that will be used when the user moves the mouse over the item. If the ImageOverUrl property is set to empty string the image specified by the ImageUrl property will be used. Use "~" (tilde) when referring to images within the current ASP.NET application.

Gets or sets the name of the field from the data source to bind to the ImageOverUrl property of a RadMenuItem object to which the RadMenuItemBinding object is applied.

The name of the field from the data source to bind to the ImageOverUrl of a RadMenuItem to which the RadMenuItemBinding is applied. The default is an empty string (""), which indicates that this property is not set.

Gets or sets the target window or frame to display the Web page content linked to when the menu item is clicked.

The target window or frame to load the Web page linked to when the Item is selected. Values must begin with a letter in the range of a through z (case insensitive), except for the following special values, which begin with an underscore: _blank Renders the content in a new window without frames. _parent Renders the content in the immediate frameset parent. _self Renders the content in the frame with focus. _top Renders the content in the full window without frames. The default value is empty string. Use the Target property to specify the frame or window that displays the Web page linked to when the menu item is clicked. The Web page is specified by setting the NavigateUrl property. If this property is not set, the Web page specified by the NavigateUrl property is loaded in the current window. The following example demonstrates how to use the Target property ASPX: <radM:RadMenu runat="server" ID="RadMenu1"> <Items> <radM:RadMenuItem Target="_blank" NavigateUrl="http://www.google.com" /> </Items> </radM:RadMenu>

Gets or sets the name of the field from the data source to bind to the Target property of a RadMenuItem object to which the RadMenuItemBinding object is applied.

The name of the field from the data source to bind to the Target of a RadMenuItem to which the RadMenuItemBinding is applied. The default is an empty string (""), which indicates that this property is not set.

Gets or sets a value indicating whether the menu item is enabled.

Use the Enabled property to specify or determine whether a menu item is functional. When set to false, the item appears dimmed.

Gets or sets the name of the field from the data source to bind to the Enabled property of a RadMenuItem object to which the RadMenuItemBinding object is applied.

The name of the field from the data source to bind to the Enabled of a RadMenuItem to which the RadMenuItemBinding is applied. The default is an empty string (""), which indicates that this property is not set.

Gets or sets the menu depth to which the RadMenuItemBinding object is applied.

When creating a RadMenuItemBinding object, you must specify the criteria for binding. The criteria indicate when a data item should be bound to a menu item. You can specify the Depth property, the DataMember property, or both. Use the Depth property to specify the menu depth at which to apply the RadMenuItemBinding object. For example, the following RadMenuItemBinding declaration binds the Name and ID fields of the data source to the Text and Value properties, respectively, of all menu items with a depth of 0:

            <asp:RadMenuItemBinding Depth="0" TextField="Name" ValueField="ID">

Sometimes you might need to create a menu item binding that specifies both a depth and a data member. This is often used when the data source contains items at different levels that have the same data member value. For example, you can have
<Item> elements that appear at different levels within an XML file. The following RadMenuItemBinding declarations show how to specify menu item bindings that apply to identical data members at different menu depths:

            		
            			<asp:RadMenuItemBinding DataMember="Item" Depth="1" TextField="Title">

            		
            			<asp:RadMenuItemBinding DataMember="Item" Depth="2" TextField="ISBN">

If a menu item binding is defined without a depth and a data member, the menu item binding is applied to all menu items within the menu. This is commonly used when all data items have the same properties and should be displayed identically, regardless of the menu depth. After the binding criteria are established, you can then bind a property of a RadMenuItem object that can be bound to a value. You can bind to a field of a data item or to a static value. When bound to a static value, all RadMenuItem objects to which the RadMenuItemBinding object is applied share the same value. Properties bound to fields contain the values of the field from the data source. If conflicting RadMenuItemBinding objects are defined, the Menu control applies the menu item bindings in the following order of precedence: The RadMenuItemBinding object that defines and matches both a depth and a data member. The RadMenuItemBinding object that defines and matches the data member only. The RadMenuItemBinding object that defines and matches the depth only. The RadMenuItemBinding object that defines neither the depth nor the data member. (This type of menu item binding is applied to all menu items in the menu.) The RadMenuItemBinding object that does not have a match in the data source. In this case, the value returned by the ToString() method of the data item is then bound to the Text and Value properties of the menu items to which the RadMenuItemBinding object is applied.

Gets or sets the string that specifies the display format for the text of a menu item to which the RadMenuItemBinding object is applied.

Utility class for Design - Time VisualStudio.NET project management.

Defines the common property categories' names

Represents the animation settings used for expand or collapse effects.

RadMenu supports a wide variety of animation effects which are represented by the AnimationSettings class. To customize the animation played when items are opened use the ExpandAnimation property. To customize the animation played when items are closed use the CollapseAnimation property.

Gets or sets the effect that will be used for the animation.

On of the AnimationType values. The default value is OutQuint. Use the Type property of the AnimationSettings class to customize the effect used for the animation. To turn off animation effects set this property to None.

Gets or sets the duration in milliseconds of the animation.

An integer representing the duration in milliseconds of the animation.

Represents the effects that can be used in an animation.

This enumeration determines the direction in which child items will open.

When set to Auto the direction is determined by the following rules If the item is top level and the parent item flow is Horizontal the direction will be Down. If the item is top level and the parent item flow is Vertical the direction will be Right. If the item is subitem (a child of another menu item rather than the RadMenu itself) the direction is Right. Note: If there is not enough room for the child items to open the expand direction is inverted. For example Right becomes Left, Down becomes Up and vice versa.

The direction is determined by parent's ItemFlow and level.

Child items open above their parent.

Child items open below their parent.

Child items open from the left side of their parent.

Child items open from the right side of their parent.

Represents the different ways menu items can flow.

The ItemFlow enumeration is used to specify the flow of submenu items.

Items will flow one below the other

Items will flow one after another

Represents a single item in the RadMenu class.

The RadMenu control is made up of a hierarchy of menu items represented by RadMenuItem objects. Menu items at the top level (level 0) that do not have a parent menu item are called root or top-level menu items. A menu item that has a parent menu item is called a submenu item. All root menu items are stored in the Items collection of the menu. Submenu items are stored in a parent menu item's Items collection. You can access a menu item's parent menu item by using the Owner property. To create the menu items for a RadMenu control, use one of the following methods: Use declarative syntax to create static menu items. Use a constructor to dynamically create new instances of the RadMenuItem class. These RadMenuItem objects can then be added to the Items collection of their owner. Bind the Menu control to a data source. When the user clicks a menu item, the Menu control can either navigate to a linked Web page or simply post back to the server. If the NavigateUrl property of a menu item is set, the RadMenu control navigates to the linked page. By default, a linked page is displayed in the same window or frame as the RadMenu control. To display the linked content in a different window or frame, use the Target property. Each menu item has a Text and a Value property. The value of the Text property is displayed in the RadMenu control, while the Value property is used to store any additional data about the menu item.

Initializes a new instance of the RadMenuItem class.

Use this constructor to create and initialize a new instance of the RadMenuItem class using default values. The following example demonstrates how to add items to RadMenu controls.


            RadMenuItem item = new RadMenuItem();
            item.Text = "News";
            item.NavigateUrl = "~/News.aspx";
             
            RadMenu1.Items.Add(item);


            Dim item As New RadMenuItem()
            item.Text = "News"
            item.NavigateUrl = "~/News.aspx"
             
            RadMenu1.Items.Add(item)

Initializes a new instance of the RadMenuItem class with the specified text data.

Use this constructor to create and initialize a new instance of the RadMenuItem class using the specified text. The following example demonstrates how to add items to RadMenu controls.


            RadMenuItem item = new RadMenuItem("News");
             
            RadMenu1.Items.Add(item);


            Dim item As New RadMenuItem("News")
             
            RadMenu1.Items.Add(item)

The text of the item. The Text property is set to the value of this parameter.

Initializes a new instance of the RadMenuItem class with the specified text and URL to navigate to.

Use this constructor to create and initialize a new instance of the RadMenuItem class using the specified text and URL. This example demonstrates how to add items to RadMenu controls.


            RadMenuItem item = new RadMenuItem("News", "~/News.aspx");
             
            RadMenu1.Items.Add(item);


            Dim item As New RadMenuItem("News", "~/News.aspx")
             
            RadMenu1.Items.Add(item)

The text of the item. The Text property is set to the value of this parameter. The url which the item will navigate to. The NavigateUrl property is set to the value of this parameter.

Creates a copy of the current RadMenuItem object.

A RadMenuItem which is a copy of the current one. Use the Clone method to create a copy of the current item. All properties of the clone are set to the same values as the current ones. Child items are not cloned.

Gets or sets the data item represented by the item.

An object representing the data item to which the Item is bound to. The DataItem property will always return null when accessed outside of MenuItemDataBound event handler. This property is applicable only during data binding. Use it along with the MenuItemDataBound event to perform additional mapping of fields from the data item to RadMenuItem properties. The following example demonstrates how to map fields from the data item to RadMenuItem properties. It assumes the user has subscribed to the MenuItemDataBound:RadMenu.MenuItemDataBound event.


            private void RadMenu1_MenuItemDataBound(object sender, Telerik.WebControls.ItemStripEventArgs e)
            {
                RadMenuItem item = e.Item;
                DataRowView dataRow = (DataRowView) e.Item.DataItem;
             
                item.ImageUrl = "image" + dataRow["ID"].ToString() + ".gif";
                item.NavigateUrl = dataRow["URL"].ToString();
            }


            Sub RadMenu1_MenuItemDataBound(ByVal sender As Object, ByVal e As ItemStripEventArgs) Handles RadMenu1.MenuItemDataBound
                Dim item As RadMenuItem = e.Item
                Dim dataRow As DataRowView = CType(e.Item.DataItem, DataRowView)
             
                item.ImageUrl = "image" + dataRow("ID").ToString() + ".gif"
                item.NavigateUrl = dataRow("URL").ToString()
            End Sub

Gets or sets the Cascading Style Sheet (CSS) class applied when the menu item is disabled.

The CSS class applied when the menu item is disabled. The default value is "disabled". By default the visual appearance of disabled menu items is defined in the skin CSS file. You can use the DisabledCssClass property to specify unique appearance for the menu item when it is disabled.

Gets or sets the Cascading Style Sheet (CSS) class applied when the menu item is opened (its child items are visible).

The CSS class applied when the menu item is opened. The default value is "expanded". By default the visual appearance of opened menu items is defined in the skin CSS file. You can use the ExpandedCssClass property to specify unique appearance for the menu item when it is opened.

Gets or sets the Cascading Style Sheet (CSS) class applied when the menu item is focused.

The CSS class applied when the menu item is focused. The default value is "focused". By default the visual appearance of focused menu items is defined in the skin CSS file. You can use the FocusedCssClass property to specify unique appearance for the menu item when it is focused.

Gets or sets the Cascading Style Sheet (CSS) class applied when the menu item is clicked.

The CSS class applied when the menu item is clicked. The default value is "clicked". By default the visual appearance of clicked menu items is defined in the skin CSS file. You can use the ClickedCssClass property to specify unique appearance for the menu item when it is clicked.

Specifies the settings for child item behavior.

Gets or sets the path to an image to display for the item.

The path to the image to display for the item. The default value is empty string. Use the ImageUrl property to specify the image for the item. If the ImageUrl property is set to empty string no image will be rendered. Use "~" (tilde) when referring to images within the current ASP.NET application. The following example demonstrates how to specify the image to display for the item using the ImageUrl property. <radm:RadMenu id="RadMenu1" runat="server">
<Items>
<radm:RadMenuItem ImageUrl="~/Img/inbox.gif" Text="Index" />
<radm:RadMenuItem ImageUrl="~/Img/outbox.gif" Text="Outbox" />
</Items>
</radm:RadMenu>

Gets or sets the path to an image to display for the item when the user moves the mouse over the item.

Gets or sets the path to an image to display for the item when the user clicks the item.

The path to the image to display when the user clicks the item. The default value is empty string. <radm:RadMenu id="RadMenu1" runat="server">
<Items>
<radm:RadMenuItem ImageUrl="~/Img/inbox.gif" ImageClickedUrl="~/Img/inboxClicked.gif" Text="Index" />
<radm:RadMenuItem ImageUrl="~/Img/outbox.gif" ImageClickedUrl="~/Img/outboxClicked.gif" Text="Outbox" />
</Items>
</radm:RadMenu> Use the ImageClickedUrl property to specify the image that will be used when the user clicks the item. If the ImageClickedUrl property is set to empty string the image specified by the ImageUrl property will be used. Use "~" (tilde) when referring to images within the current ASP.NET application.

Gets or sets the path to an image to display when the items is disabled.

The path to the image to display when the item is disabled. The default value is empty string. Use the DisabledImageUrl property to specify the image that will be used when the item is disabled. If the DisabledImageUrl property is set to empty string the image specified by the ImageUrl property will be used. Use "~" (tilde) when referring to images within the current ASP.NET application. <radm:RadMenu id="RadMenu1" runat="server">
<Items>
<radm:RadMenuItem ImageUrl="~/Img/inbox.gif" DisabledImageUrl="~/Img/inboxDisabled.gif" Text="Index" />
<radm:RadMenuItem ImageUrl="~/Img/outbox.gif" DisabledImageUrl="~/Img/outboxDisabled.gif" Text="Outbox" />
</Items>
</radm:RadMenu>

Gets or sets the path to an image to display when the items is expanded.

The path to the image to display when the item is expanded. The default value is empty string. <radm:RadMenu id="RadMenu1" runat="server">
<Items>
<radm:RadMenuItem ImageUrl="~/Img/inbox.gif" ExpandedImageUrl="~/Img/inboxExpanded.gif" Text="Index" />
<radm:RadMenuItem ImageUrl="~/Img/outbox.gif" ExpandedImageUrl="~/Img/outboxExpanded.gif" Text="Outbox" />
</Items>
</radm:RadMenu> Use the ExpandedImageUrl property to specify the image that will be used when the item is expanded. If the ExpandedImageUrl property is set to empty string the image specified by the ImageUrl property will be used. Use "~" (tilde) when referring to images within the current ASP.NET application.

Gets the zero based index of the item in the Items collection of its parent.

An integer specifying the zero based index of the item considering the RadMenuItemCollection that contains it.

Sets or gets whether the item is separator. It also represents a logical state of the item. Might be used in some applications for keyboard navigation to omit processing items that are marked as separators.

Gets or sets the template for displaying the item.

A ITemplate implemented object that contains the template for displaying the item. The default value is a null reference (Nothing in Visual Basic), which indicates that this property is not set. To specify common display for all menu items use the ItemTemplate property of the RadMenu class. The following template demonstrates how to add a Calendar control in certain menu item. ASPX: <radM:RadMenu runat="server" ID="RadMenu1">

<Items>
<radM:RadMenuItem Text="Date">
<Items>
<radM:RadMenuItem Text="SelectDate">
<ItemTemplate>
<asp:Calendar runat="server" ID="Calendar1" />
</ItemTemplate>
</radM:RadMenuItem>
</Items>
</radM:RadMenuItem>
</Items>

</radM:RadMenu>

Gets the collection of child items in the menu item.

A RadMenuItemCollection that represents the children within the menu item. The default is empty collection. Use this property to retrieve the child items of the menu item. You can also use it to programmatically add or remove child items. The following example demonstrates how to programmatically add child items.


            void Page_Load(object sender, EventArgs e)
            {
                if (!Page.IsPostBack)
                {
                    RadMenuItem newsItem = new RadMenuItem("News");
                    RadMenu1.Items.Add(newsItem);
                
                    RadMenuItem cnnItem = new RadMenuItem("CNN");
                    newsItem.Items.Add(cnnItem);
             
                    RadMenuItem nbcItem = new RadMenuItem("NBC");
                    newsItem.Items.Add(nbcItem);
                }
            }


            Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load
                If Not Page.IsPostBack Then
                    Dim newsItem As RadMenuItem = New RadMenuItem("News")
                    RadMenu1.Items.Add(newsItem)
             
                    Dim cnnItem As RadMenuItem = New RadMenuItem("CNN")
                    newsItem.Items.Add(cnnItem)
             
                    Dim nbcItem As RadMenuItem = New RadMenuItem("NBC")
                    newsItem.Items.Add(nbcItem)
                End If
            End Sub

Manages the item level of a particular Item instance. This property allows easy implementation/separation of the menu items in levels.

Gets the RadMenu instance which contains the item.

Use this property to obtain an instance to the RadMenu object containing the item.

Gets or sets the URL to link to when the item is clicked.

Gets the IRadMenuItemContainer which contains the item.

The object which contains the item. It might be an instance of the RadMenu class or the RadMenuItem class depending on the hierarchy level. The value is of the IRadMenuItemContainer type which is implemented by the RadMenu class and the RadMenuItem class. Use the Owner property when recursively traversing RadMenu.

Gets or sets the target window or frame to display the Web page content linked to when the menu item is clicked.

Gets or sets the text caption for the menu item.

The text of the item. The default value is empty string. This example demonstrates how to set the text of the item using the Text property. <radM:RadMenu ID="RadMenu1" runat="server">
<Items>
<radM:RadMenuItem Text="News" />
<radM:RadMenuItem Text="News" />
</Items>
</radM:RadMenu> Use the Text property to specify the text to display for the item.

Gets or sets the value associated with the menu item.

The value associated with the item. The default value is empty string. Use the Value property to specify or determine the value associated with the item.

This property is being used internally by the RadMenu control. Setting it may lead to unpredictable results.

The ID property is used internally. Use the Value property to store any item related data.

Gets or sets a value indicating whether clicking on the item will postback.

True if the menu item should postback; otherwise false. By default all the items will postback provided the user has subscribed to the ItemClick event. If you subscribe to the ItemClick all menu items will postback. To turn off that behavior you should set the PostBack property to false. This property cannot be set in design time.

A collection of RadMenuItem objects in a RadMenu control.

The RadMenuItemCollection class represents a collection of RadMenuItem objects. The RadMenuItem objects in turn represent menu items within a RadMenu control. Use the indexer to programmatically retrieve a single RadMenuItem from the collection, using array notation. Use the Count property to determine the total number of menu items in the collection. Use the Add method to add menu items in the collection. Use the Remove method to remove menu items from the collection.

Initializes a new instance of the RadMenuItemCollection class.

Use the constructor to create a new RadMenuItemCollection class. The owner of the collection.

Appends a RadMenuItem to the end of the collection.

The following example demonstrates how to programmatically add items in a RadMenu control.


            RadMenuItem newsItem = new RadMenuItem("News");
             
            RadMenu1.Items.Add(newsItem);


            Dim newsItem As RadMenuItem = New RadMenuItem("News")
             
            RadMenu1.Items.Add(newsItem)

Adds the items in an array of RadMenuItem objects to the collection.

Use the AddRange method to add the items in the array of RadMenuItem objects specified by the items parameter. This allows you to add multiple RadMenuItem objects to the collection in a single step. The following example demonstrates how to use the AddRange method to add multiple items in a single step.


            void Page_Load(object sender, EventArgs e)
            {
                if (!Page.IsPostBack)
                {
                    RadMenuItem[] items = new RadMenuItem[] { new RadMenuItem("First"), new RadMenuItem("Second"), new RadMenuItem("Third") };
                    RadMenu1.Items.AddRange(items);
                }
            }


            Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load
                If Not Page.IsPostBack Then
                    Dim items() As RadMenuItem = {New RadMenuItem("First"), New RadMenuItem("Second"), New RadMenuItem("Third")}
                    RadMenu1.Items.AddRange(items)
                End If
            End Sub

Inserts the specified RadMenuItem in the collection at the specified index location.

Use the Insert method to add a RadMenuItem to the collection at the index specified by the index parameter. The location in the collection to insert the RadMenuItem. The RadMenuItem to add to the collection.

Determines the index value that represents the position of the specified RadMenuItem in the collection.

The zero-based index position of the specified RadMenuItem in the collection. Use the IndexOf method to determine the index value of the RadMenuItem specified by the item parameter in the collection. If an item with this criteria is not found in the collection, -1 is returned. A RadMenuItem to search for in the collection.

Determines whether the collection contains the specified RadMenuItem.

true if the collection contains the specified item; otherwise, false. Use the Contains method to determine whether the RadMenuItem specified by the item parameter is in the collection. A RadMenuItem to search for in the collection.

Removes the specified RadMenuItem from the collection.

Use the Remove method to remove a RadMenuItem from the collection. The following example demonstrates how to programmatically remove a RadMenuItem from a RadMenu control.


            RadMenuItem newsItem = RadMenu1.FindItemByText("News");
            if (newsItem != null)
            {
                RadMenu1.Items.Remove(newsItem);
            }


            Dim newsItem As RadMenuItem = RadMenu1.FindItemByText("News")
            If Not newsItem Is Nothing Then
                RadMenu1.Items.Remove(newsItem)
            End If

Removes the RadMenuItem at the specified index from the collection.

Use the RemoveAt method to remove the RadMenuItem at the specified index from the collection. The index of the RadMenuItem to remove.

Removes all items from the collection.

Use the Clear method to remove all items from the collection. The Count property is set to 0.

Searches the RadMenuItemCollection for the first RadMenuItem with a Text property equal to the specified value.

Searches the RadMenuItemCollection for the first RadMenuItem with a Value property equal to the specified value.

Searches the RadMenuItemCollection for the first Item with a NavigateUrl property equal to the specified value.

Gets a RadMenuItem at the specified index in the collection.

Use this indexer to get a RadMenuItem from the collection at the specified index, using array notation. The zero-based index of the RadMenuItem to retrieve from the collection.

Represents settings controlling child item behavior.

Gets or sets the flow of child items.

One of the ItemFlow enumeration values. The default value is Vertical. Use the Flow property to customize the flow of child menu items. By default RadMenu mimics the behavior of Windows and child items (apart from top level ones) flow vertically.

Gets or sets the direction in which child items will open.

One of the ExpandDirection enumeration values. The default value is Auto. Use the ExpandDirection property to specify different expand direction than the automatically determined one. See the ExpandDirection description for more information.

Gets or sets a value indicating the horizontal offset of child menu items considering their parent.

An integer specifying the horizontal offset of child menu items (measured in pixels). The default value is 0 (no offset). Use the OffsetX property to change the position where child items will appear. To customize the vertical offset use the OffsetY property.

Gets or sets a value indicating the vertical offset of child menu items considering their parent.

An integer specifying the vertical offset of child menu items (measured in pixels). The default value is 0 (no offset). Use the OffsetY property to change the position where child items will appear. To customize the horizontal offset use the OffsetX property.

Gets or sets a value indicating the width of child menu items (the whole item group).

A Unit that represents the width of the child item group. The default value is Unit.Empty. If the total width of menu items exceeds the Width property scrolling will be applied.

Gets or sets a value indicating the height of child menu items (the whole item group).

A Unit that represents the height of the child item group. The default value is Unit.Empty. If the total height of menu items exceeds the Height property scrolling will be applied.