MenuItem.Selectable Eigenschaft

Definition

Ruft einen Wert ab, der angibt, ob das MenuItem-Objekt ausgewählt werden kann oder ob darauf geklickt werden kann, oder legt diesen Wert fest.Gets or sets a value that indicates whether the MenuItem object can be selected, or is "clickable."

public:
 property bool Selectable { bool get(); void set(bool value); };
[System.ComponentModel.Browsable(true)]
public bool Selectable { get; set; }
member this.Selectable : bool with get, set
Public Property Selectable As Boolean

Eigenschaftswert

true, wenn das Menüelement ausgewählt werden kann, andernfalls false.true if the menu item can be selected; otherwise, false.

Attribute

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie ein Menü Element, bei dem die Selectable-Eigenschaft auf festgelegt ist false angezeigt wird und in einem Menü fungiert.The following example demonstrates how a menu item with the Selectable property set to false appears and functions in a 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>

Hinweise

Wenn diese Eigenschaft für ein Menü Element auf false festgelegt ist, wird keine Aktion ausgeführt, wenn auf das Menü Element geklickt wird (ausgewählt).When this property is set to false on a menu item, no action occurs when the menu item is clicked (selected). Das Popup Bild, das die untergeordneten Menü Elemente für das Menü Element anzeigt, wird immer noch angezeigt und ist verfügbar.The pop-out image indicating child menu items for the menu item, if one exists, is still shown and available.

Wenn Sie nicht möchten, dass untergeordnete Menü Elemente für ein Menü Element angezeigt werden, legen Sie die Enabled-Eigenschaft auf falsefest.If you do not want any child menu items to appear for a menu item, set the Enabled property to false.

Selectable gilt nur für Menü Elemente, die ausgewählt werden können. Dies ist sinnvoll, wenn auf ein Menü Element zurück gepostet wird und dieses Element im ausgewählten Zustand festgelegt wird.Selectable applies only to menu items that can be selected, in the sense that clicking a menu item posts back and sets that item in the selected state. Beachten Sie, dass ein Menü Element, das nicht ausgewählt werden kann, weiterhin als Link formatiert ist.Note that a menu item that cannot be selected is still formatted as a link. Dies ist aus Gründen der Barrierefreiheit, damit das Menü Element eine Aktion auslösen kann.This is for accessibility reasons, so that the menu item can cause an action to occur. Außerdem kann ein Menü Element, auch wenn es nicht ausgewählt werden kann, untergeordnete Menü Elemente aufweisen, die ausgewählt oder angezeigt werden müssen.Also, a menu item, even if it cannot be selected, may have child menu items that can be selected or that need to be displayed.

Wenn Sie verhindern möchten, dass ein Benutzer auf ein Menü Element klickt, führen Sie einen der folgenden Schritte aus:If you want to prevent a user from clicking a menu item, do one of the following:

Gilt für:

Siehe auch