Menu.SkipLinkText Eigenschaft

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ruft den alternativen Text für ein ausgeblendetes Bild ab, das von Bildschirmsprachausgaben gelesen wird, um die Möglichkeit zu bieten, die Liste der Links zu überspringen, oder legt diesen fest.

public:
 property System::String ^ SkipLinkText { System::String ^ get(); void set(System::String ^ value); };
public string SkipLinkText { get; set; }
member this.SkipLinkText : string with get, set
Public Property SkipLinkText As String

Eigenschaftswert

String

Der alternative Text eines ausgeblendeten Bilds, das von Bildschirmsprachausgaben gelesen wird, um die Möglichkeit zu bieten, die Liste der Links zu überspringen. Der Standardwert ist eine leere Zeichenfolge (""), die angibt, dass diese Eigenschaft nicht festgelegt ist.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie SkipLinkText die Eigenschaft verwendet wird, um den alternativen Text für ein ausgeblendetes Bild anzugeben, das von Bildschirmsprachausgaben gelesen wird, um die Möglichkeit zu bieten, die Liste der Links zu überspringen.


<%@ 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 SkipLinkText Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>Menu SkipLinkText Example</h3>

      <asp:menu id="NavigationMenu"
        staticdisplaylevels="2"
        staticsubmenuindent="10" 
        orientation="Vertical"
        skiplinktext="Skip Menu" 
        runat="server">
      
        <items>
          <asp:menuitem text="Home"
            tooltip="Home">
            <asp:menuitem text="Music"
              tooltip="Music">
              <asp:menuitem text="Classical"
                tooltip="Classical"/>
              <asp:menuitem text="Rock"
                tooltip="Rock"/>
              <asp:menuitem text="Jazz"
                tooltip="Jazz"/>
            </asp:menuitem>
            <asp:menuitem text="Movies"
              tooltip="Movies">
              <asp:menuitem text="Action"
                tooltip="Action"/>
              <asp:menuitem text="Drama"
                tooltip="Drama"/>
              <asp:menuitem text="Musical"
                tooltip="Musical"/>
            </asp:menuitem>
          </asp:menuitem>
        </items>
      
      </asp:menu>

    </form>
  </body>
</html>


<%@ 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 SkipLinkText Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>Menu SkipLinkText Example</h3>

      <asp:menu id="NavigationMenu"
        staticdisplaylevels="2"
        staticsubmenuindent="10" 
        orientation="Vertical"
        skiplinktext="Skip Menu" 
        runat="server">
      
        <items>
          <asp:menuitem text="Home"
            tooltip="Home">
            <asp:menuitem text="Music"
              tooltip="Music">
              <asp:menuitem text="Classical"
                tooltip="Classical"/>
              <asp:menuitem text="Rock"
                tooltip="Rock"/>
              <asp:menuitem text="Jazz"
                tooltip="Jazz"/>
            </asp:menuitem>
            <asp:menuitem text="Movies"
              tooltip="Movies">
              <asp:menuitem text="Action"
                tooltip="Action"/>
              <asp:menuitem text="Drama"
                tooltip="Drama"/>
              <asp:menuitem text="Musical"
                tooltip="Musical"/>
            </asp:menuitem>
          </asp:menuitem>
        </items>
      
      </asp:menu>

    </form>
  </body>
</html>

Hinweise

Verwenden Sie die SkipLinkText Eigenschaft, um den alternativen Text für ein ausgeblendetes Bild anzugeben, das von Bildschirmsprachausgaben gelesen wird, um die Möglichkeit zu bieten, die Liste der Links zu überspringen. Der von Ihnen angegebene Text stellt Hilfstechnologiegeräte mit einer Beschreibung des Ausgeblendeten Skip-Link-Bilds bereit, das verwendet werden kann, um das Steuerelement barrierefreier zu gestalten.

Der Wert dieser Eigenschaft kann automatisch mithilfe eines Designertools in einer Ressourcendatei gespeichert werden. Weitere Informationen finden Sie unter LocalizableAttribute"Globalisierung und Lokalisierung".

Das Menu Steuerelement stellt die SkipLinkText Eigenschaft als Möglichkeit bereit, das gesamte Steuerelement von Bildschirmsprachausgaben übersprungen zu werden. Wenn die SkipLinkText Eigenschaft festgelegt ist, wird ein unsichtbares Bild mit alternativem Text gerendert, sodass der Benutzer die Möglichkeit hat, zum Ende des Steuerelements zu springen. Bildschirmsprachausgaben lesen den Alternativtext laut vor, und das Bild belegt nur einen Pixelraum. Legen Sie für pixelgenaue Kontrolle über das Rendern der Seite die SkipLinkText Eigenschaft auf eine leere Zeichenfolge ("") fest, und stellen Sie einen eigenen Mechanismus zum Überspringen des Menüs bereit. Die SkipLinkText Eigenschaft wird standardmäßig auf die leere Zeichenfolge festgelegt.

Gilt für:

Weitere Informationen