MenuItem.Enabled Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece un valor que indica si el objeto MenuItem se encuentra habilitado, lo cual permite al elemento mostrar una imagen desplegable y cualquier elemento de menú secundario.
public:
property bool Enabled { bool get(); void set(bool value); };
[System.ComponentModel.Browsable(true)]
public bool Enabled { get; set; }
[<System.ComponentModel.Browsable(true)>]
member this.Enabled : bool with get, set
Public Property Enabled As Boolean
Valor de propiedad
true
si el elemento de menú está habilitado; en caso contrario, false
.
- Atributos
Ejemplos
En el ejemplo siguiente se muestra cómo aparece un elemento de menú con la Enabled propiedad establecida false
en y funciona en un menú.
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Menu Selectable and Enabled properties Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Menu Selectable and Enabled properties Example</h3>
Note that Home, set to Selectable=false, is unselectable, but still shows all child items.<br />
Movies, set to Enabled=false, is unselectable, is greyed out, and does not show child items. <br />
<asp:menu id="NavigationMenu"
staticdisplaylevels="1"
staticsubmenuindent="10"
orientation="Vertical"
target="_blank"
runat="server">
<dynamicmenustyle backcolor="LightSkyBlue"
forecolor="Black"
borderstyle="Solid"
borderwidth="1"
bordercolor="Black" />
<items>
<asp:menuitem navigateurl="Home.aspx"
text="Non-Selectable"
tooltip="Non-Selectable"
Selectable="false">
<asp:menuitem navigateurl="Music.aspx"
text="Music"
tooltip="Music">
<asp:menuitem navigateurl="Classical.aspx"
text="Classical"
tooltip="Classical"/>
<asp:menuitem navigateurl="Rock.aspx"
text="Rock"
tooltip="Rock"/>
<asp:menuitem navigateurl="Jazz.aspx"
text="Jazz"
tooltip="Jazz"/>
</asp:menuitem>
<asp:menuitem navigateurl="Movies.aspx"
text="Disabled"
tooltip="Disabled"
Enabled="false">
<asp:menuitem navigateurl="Action.aspx"
text="Action"
tooltip="Action"/>
<asp:menuitem navigateurl="Drama.aspx"
text="Drama"
tooltip="Drama"/>
<asp:menuitem navigateurl="Musical.aspx"
text="Musical"
tooltip="Musical"/>
</asp:menuitem>
</asp:menuitem>
</items>
</asp:menu>
</form>
</body>
</html>
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Menu Selectable and Enabled properties Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Menu Selectable and Enabled properties Example</h3>
Note that Home, set to Selectable=false, is unselectable, but still shows all child items.<br />
Movies, set to Enabled=false, is unselectable, is greyed out, and does not show child items. <br />
<asp:menu id="NavigationMenu"
staticdisplaylevels="1"
staticsubmenuindent="10"
orientation="Vertical"
target="_blank"
runat="server">
<dynamicmenustyle backcolor="LightSkyBlue"
forecolor="Black"
borderstyle="Solid"
borderwidth="1"
bordercolor="Black" />
<items>
<asp:menuitem navigateurl="Home.aspx"
text="Non-Selectable"
tooltip="Non-Selectable"
Selectable="false">
<asp:menuitem navigateurl="Music.aspx"
text="Music"
tooltip="Music">
<asp:menuitem navigateurl="Classical.aspx"
text="Classical"
tooltip="Classical"/>
<asp:menuitem navigateurl="Rock.aspx"
text="Rock"
tooltip="Rock"/>
<asp:menuitem navigateurl="Jazz.aspx"
text="Jazz"
tooltip="Jazz"/>
</asp:menuitem>
<asp:menuitem navigateurl="Movies.aspx"
text="Disabled"
tooltip="Disabled"
Enabled="false">
<asp:menuitem navigateurl="Action.aspx"
text="Action"
tooltip="Action"/>
<asp:menuitem navigateurl="Drama.aspx"
text="Drama"
tooltip="Drama"/>
<asp:menuitem navigateurl="Musical.aspx"
text="Musical"
tooltip="Musical"/>
</asp:menuitem>
</asp:menuitem>
</items>
</asp:menu>
</form>
</body>
</html>
Comentarios
Cuando esta propiedad se establece false
en , el elemento de menú está deshabilitado y no se muestra ninguna imagen emergente que indique los elementos secundarios. Establecer esta propiedad false
en para un elemento de menú básicamente hace que el elemento de menú sea el final de ese nodo, donde no se muestran más niveles fuera de ese nodo. El valor predeterminado es true
.
Si desea que el elemento de menú muestre elementos secundarios, pero no sea "clickable", use la Selectable propiedad y establézcalo false
en .