MenuItem.Selectable Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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.

public:
 property bool Selectable { bool get(); void set(bool value); };

[System.ComponentModel.Browsable(true)]
public bool Selectable { get; set; }

[<System.ComponentModel.Browsable(true)>]
member this.Selectable : bool with get, set

Public Property Selectable As Boolean

Eigenschaftswert

Boolean

true, wenn das Menüelement ausgewählt werden kann, andernfalls false.

Attribute: BrowsableAttribute

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie ein Menüelement mit der Selectable - false Eigenschaft angezeigt wird und in einem Menü funktioniert.


<%@ 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 (ausgewählt) wird. Das Popupbild, das untergeordnete Menüelemente für das Menüelement angibt, sofern vorhanden, wird weiterhin angezeigt und ist verfügbar.

Wenn für ein Menüelement keine untergeordneten Menüelemente angezeigt werden sollen, legen Sie die Enabled -Eigenschaft auf fest false.

Selectable gilt nur für Menüelemente, die ausgewählt werden können, in dem Sinne, dass das Klicken auf ein Menüelement zurückgibt und dieses Element im ausgewählten Zustand festlegt. Beachten Sie, dass ein Menüelement, das nicht ausgewählt werden kann, weiterhin als Link formatiert ist. Dies erfolgt aus Barrierefreiheitsgründen, sodass das Menüelement zu einer Aktion führen kann. Außerdem kann ein Menüelement, auch wenn es nicht ausgewählt werden kann, untergeordnete Menüelemente aufweisen, die ausgewählt werden können oder angezeigt werden müssen.

Wenn Sie verhindern möchten, dass ein Benutzer auf ein Menüelement klickt, führen Sie eine der folgenden Aktionen aus:

Legen Sie nicht fest NavigateUrl , und legen Sie sie nicht auf fest Selectablefalse.
Legen Sie die -Eigenschaft des Menüelements Enabled auf fest false.

Gilt für:

Weitere Informationen

Enabled