Menu.SkipLinkText Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define o texto alternativo para uma imagem oculta lida pelos leitores de ecrã, permitindo saltar a lista de links.
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
Valor de Propriedade
O texto alternativo de uma imagem oculta lida por leitores de ecrã para permitir a possibilidade de saltar a lista de links. O padrão é uma cadeia vazia (""), o que indica que esta propriedade não está definida.
Exemplos
O exemplo de código seguinte demonstra como usar a SkipLinkText propriedade para especificar o texto alternativo para uma imagem oculta lida por leitores de ecrã, de modo a permitir a possibilidade de saltar a lista de links.
<%@ 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>
Observações
Use a SkipLinkText propriedade para especificar o texto alternativo para uma imagem oculta lida por leitores de ecrã, permitindo saltar a lista de links. O texto que especifica fornece dispositivos de tecnologia assistiva com uma descrição da imagem oculta do link de salto que pode ser usada para tornar o controlo mais acessível.
O valor desta propriedade, quando definido, pode ser guardado automaticamente num ficheiro de recurso usando uma ferramenta de design. Para mais informações, veja LocalizableAttributeGlobalização e Localização.
O Menu controlo fornece a SkipLinkText propriedade como uma forma de ignorar todo o controlo pelos leitores de ecrã. Se a SkipLinkText propriedade estiver definida, uma imagem invisível com texto alternativo é renderizada, dando ao utilizador a opção de saltar para o final do controlo. Os leitores de ecrã leem o texto alternativo em voz alta, e a imagem ocupa apenas um espaço de píxeis. Para controlo pixel-preciso sobre a renderização da página, define a SkipLinkText propriedade para uma cadeia vazia ("") e fornece o teu próprio mecanismo para saltar o menu. A SkipLinkText propriedade está definida para a cadeia vazia por defeito.