Menu.SkipLinkText 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 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 die SkipLinkText -Eigenschaft verwendet wird, um den alternativen Text für ein ausgeblendetes Bild anzugeben, das von Sprachausgaben 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 Sprachausgaben gelesen wird, um die Möglichkeit zu bieten, die Liste der Links zu überspringen. Der von Ihnen angegebene Text enthält Hilfstechnologiegeräte mit einer Beschreibung des ausgeblendeten SkipLink-Bilds, das verwendet werden kann, um den Zugriff auf das Steuerelement zu verbessern.

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 stellt die SkipLinkText -Eigenschaft bereit, um das gesamte Steuerelement von Sprachausgaben zu überspringen. Wenn die SkipLinkText -Eigenschaft festgelegt ist, wird ein unsichtbares Bild mit alternativem Text gerendert, sodass der Benutzer an das Ende des Steuerelements springen kann. Sprachausgaben lesen den alternativen Text laut vor, und das Bild belegt nur einen Pixelbereich. Legen Sie für die pixelgenaue Steuerung des Renderings 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 ist standardmäßig auf die leere Zeichenfolge festgelegt.

Gilt für:

Freigeben über