ASPxClientMenuItem.SetEnabled(value) Method
Specifies whether the menu item is enabled.
Declaration
SetEnabled(
value: boolean
): voidParameters
| 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.
<%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" %>
<%@ Register Assembly="DevExpress.Web.v8.3" Namespace="DevExpress.Web.ASPxMenu"
TagPrefix="dxm" %>
<%@ Register Assembly="DevExpress.Web.v8.3" Namespace="DevExpress.Web.ASPxEditors"
TagPrefix="dxe" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
</script>
<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