MenuItem.Enabled Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit une valeur qui indique si l'objet MenuItem est activé, ce qui permet à l'élément d'afficher une image contextuelle et tous les éléments de menu enfants.
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
Valeur de propriété
true
si l'élément de menu est activé ; sinon, false
.
- Attributs
Exemples
L’exemple suivant montre comment un élément de menu avec la Enabled propriété définie s’affiche false
et fonctionne dans un menu.
<%@ 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>
Remarques
Lorsque cette propriété est définie sur false
, l’élément de menu est désactivé et aucune image contextuelle indiquant que les éléments enfants sont affichés. La définition de cette propriété false
pour un élément de menu rend essentiellement l’élément de menu fin de ce nœud, où aucun autre niveau n’est affiché sur ce nœud. La valeur par défaut est true
.
Si vous souhaitez que l’élément de menu affiche les éléments enfants, mais qu’il ne soit pas « clickable », utilisez la propriété et définissez-la Selectable false
sur .