Freigeben über

Menu.SkipLinkText Eigenschaft

  • Referenz

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 und das Überspringen der Linkliste ermöglicht, oder legt diesen Text 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 für ein ausgeblendetes Bild, das von Bildschirmsprachausgaben gelesen wird und das Überspringen der Linkliste ermöglicht. Der Standardwert ist eine leere Zeichenfolge ("") und gibt an, dass diese Eigenschaft nicht festgelegt ist.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die SkipLinkText Eigenschaft verwenden, 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 bietet Hilfstechnologiegeräte mit einer Beschreibung des ausgeblendeten Linkbilds, das verwendet werden kann, um das Steuerelement zugänglicher zu machen.

Der Wert dieser Eigenschaft, wenn festgelegt, kann mithilfe eines Designers Tools automatisch zu einer Ressourcendatei gespeichert werden. Weitere Informationen finden Sie unter LocalizableAttribute und Globalisierung und Lokalisierung.

Das Menu Steuerelement bietet die SkipLinkText Eigenschaft als Möglichkeit für das gesamte Steuerelement, das von Bildschirmsprachausgaben übersprungen werden soll. Wenn die SkipLinkText Eigenschaft festgelegt ist, wird ein unsichtbares Bild mit alternativem Text gerendert, wodurch der Benutzer die Option zum Ende des Steuerelements springen kann. Bildschirmsprachausgaben lesen den alternativen Text 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 ihren eigenen Mechanismus bereit, um das Menü zu überspringen. Die SkipLinkText Eigenschaft wird standardmäßig auf die leere Zeichenfolge festgelegt.

Gilt für

Siehe auch