Skip to main content

ASPxClientMenuItem.SetEnabled(value) Method

Specifies whether the menu item is enabled.

Declaration

SetEnabled(
    value: boolean
): void

Parameters

Name Type Description
value boolean

true to enable the menu item; otherwise, false.

Remarks

Use the SetEnabled method on the client to dynamically change a menu item’s ability to respond to end-user interactions (such as mouse hovering or clicks). The item’s initial availability state can be defined by using the MenuItem.ClientEnabled property.

Note

The SetEnabled method is not in effect if a menu item is initially disabled on the server by setting the MenuItem.Enabled property to false.

Example

This example demonstrates how specific item characteristics (the text, visibility, availability to end-users, checked state) of a control (the ASPxMenu in this case) can be changed on the client side using available JavaScript methods.

<html xmlns="http://www.w3.org/1999/xhtml" >
 <head id="Head1" runat="server">
     <title>Client methods that affect an item's visibility, 
    text, navigation location and associated image</title>
 </head>
 <body>
     <form id="form2" runat="server">
     <div>
         <table border="0" cellpadding="2" cellspacing="0"><tr>
             <td><dxe:ASPxCheckBox ID="cbVisible" Checked="True" runat="server" Text="Visible">
                 <ClientSideEvents CheckedChanged="function(s, e) {
    myMenu.GetItem(0).SetVisible(s.GetChecked());
 }" />
             </dxe:ASPxCheckBox></td>
         </tr><tr>
             <td><dxe:ASPxCheckBox ID="cbEnabled" Checked="True" runat="server" Text="Enabled">
                 <ClientSideEvents CheckedChanged="function(s, e) {
    myMenu.GetItem(0).SetEnabled(s.GetChecked());
 }" />
             </dxe:ASPxCheckBox></td>
         </tr><tr>
             <td><dxe:ASPxCheckBox ID="cbChecked" Checked="False" runat="server" Text="Checked">
                 <ClientSideEvents CheckedChanged="function(s, e) {
    myMenu.GetItem(0).SetChecked(s.GetChecked());
 }" />
             </dxe:ASPxCheckBox></td>
         </tr><tr>
             <td><dxe:ASPxButton ID="bText" runat="server" Text="SetText()" AutoPostBack="False">
                 <ClientSideEvents Click="function(s, e) {
    myMenu.GetItem(0).SetText('Text is changed');
 }" />
             </dxe:ASPxButton></td>
         </tr><tr>
             <td><dxe:ASPxButton ID="bNavigateUrl" runat="server" 
            Text="SetNavigateUrl()" AutoPostBack="False">
                 <ClientSideEvents Click="function(s, e) {
    myMenu.GetItem(0).SetNavigateUrl('http://www.google.com');
 }" />
             </dxe:ASPxButton></td>
         </tr><tr>
             <td><dxe:ASPxButton ID="bImageUrl" runat="server" 
            Text="SetImageUrl()" AutoPostBack="False">
                 <ClientSideEvents Click="function(s, e) {
    myMenu.GetItem(0).SetImageUrl('Images/UserSelected.gif');
 }" />
             </dxe:ASPxButton></td>
         </tr></table>
         <br/>
         <dxm:ASPxMenu ID="ASPxMenu1" runat="server" ClientInstanceName="myMenu" 
          ItemImagePosition="Top">
             <Items>
                 <dxm:MenuItem Text="Menu Item" GroupName="SingleGroup" 
                      NavigateUrl='http://www.yahoo.com'>
                     <Image Url="Images/User.gif" 
                    UrlDisabled="../Images/Images/UserDisabled.gif" />
                 </dxm:MenuItem>
                 <dxm:MenuItem Text="Menu Item">
                     <Image Url="Images/User.gif" />
                 </dxm:MenuItem>
             </Items>
         </dxm:ASPxMenu>
     </div>
     </form>
 </body>
 </html>
See Also