WebControl.TabIndex Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define o índice de tabulação do controle do servidor Web.
public:
virtual property short TabIndex { short get(); void set(short value); };public virtual short TabIndex { get; set; }member this.TabIndex : int16 with get, setPublic Overridable Property TabIndex As ShortValor da propriedade
O índice de tabulação do controle de servidor Web. O padrão é 0, que indica que essa propriedade não está definida.
Exceções
O índice de tabulação especificado não está entre -32768 e 32767.
Exemplos
O exemplo a seguir ilustra como usar a TabIndex propriedade do WebControl para definir a ordem de tabulação dos controles na página.
Observação
O exemplo de código a seguir usa o modelo de código de arquivo único e pode não funcionar corretamente se for copiado diretamente em um arquivo code-behind. Este exemplo de código deve ser copiado em um arquivo de texto vazio que tenha uma extensão .aspx. Para obter mais informações sobre o modelo de código Web Forms, consulte ASP.NET Web Forms Modelo de Código de Página.
Importante
Este exemplo tem uma caixa de texto que aceita a entrada do usuário, que é uma ameaça à segurança em potencial. Por padrão, ASP.NET páginas da Web validam que a entrada do usuário não inclui elementos HTML ou script. Para obter mais informações, consulte Visão geral de explorações de script.
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void SubmitBtn1_Click(Object sender, EventArgs e)
{
SubmitBtn1.TabIndex = 0;
TextBox1.TabIndex = (short)((TextBox1.Text=="") ? 0 :
System.Int32.Parse(TextBox1.Text));
TextBox2.TabIndex = (short)((TextBox2.Text=="") ? 0 :
System.Int32.Parse(TextBox2.Text));
TextBox3.TabIndex = (short)((TextBox3.Text=="") ? 0 :
System.Int32.Parse(TextBox3.Text));
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head2" runat="server">
<title>Enabled Property Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h3>TabIndex Property of a Web Control<br /></h3>
<p>
Enter a number (1, 2, or 3) in each text box, <br />
click the Submit button to set the TabIndexes, then <br />
click on the page and tab through the page to verify.
</p>
<p><asp:Button id="SubmitBtn1" OnClick="SubmitBtn1_Click"
Text="Submit" runat="server"/>
</p>
<p><asp:TextBox id="TextBox1" BackColor="Pink"
runat="server"/>
</p>
<p><asp:TextBox id="TextBox2" BackColor="LightBlue"
runat="server"/>
</p>
<p><asp:TextBox id="TextBox3" BackColor="LightGreen"
runat="server"/>
</p>
</div>
</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">
<script runat="server">
Sub SubmitBtn1_Click(sender As Object, e As EventArgs)
SubmitBtn1.TabIndex = 0
If TextBox1.Text = "" Then
TextBox1.TabIndex = 0
Else
TextBox1.TabIndex = System.Int16.Parse(TextBox1.Text)
End If
If TextBox2.Text = "" Then
TextBox2.TabIndex = 0
Else
TextBox2.TabIndex = System.Int16.Parse(TextBox2.Text)
End If
If TextBox3.Text = "" Then
TextBox3.TabIndex = 0
Else
TextBox3.TabIndex = System.Int16.Parse(TextBox3.Text)
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head2" runat="server">
<title>Enabled Property Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<h3>TabIndex Property of a Web Control<br /></h3>
<p>
Enter a number (1, 2, or 3) in each text box, <br />
click the Submit button to set the TabIndexes, then <br />
click on the page and tab through the page to verify.
</p>
<asp:Button id="SubmitBtn1" OnClick="SubmitBtn1_Click"
Text="Submit" runat="server"/>
<p>
<asp:TextBox id="TextBox1" BackColor="Pink"
runat="server"/>
</p>
<p>
<asp:TextBox id="TextBox2" BackColor="LightBlue"
runat="server"/>
</p>
<p>
<asp:TextBox id="TextBox3" BackColor="LightGreen"
runat="server"/>
</p>
</div>
</form>
</body>
</html>
Comentários
Use a TabIndex propriedade para especificar ou determinar o índice de guia de um controle de servidor Web na página Web Forms. Quando você pressiona a Tab tecla, a ordem na qual os controles do servidor Web recebem foco é determinada pela TabIndex propriedade de cada controle. Quando uma página é carregada inicialmente, o primeiro item que recebe foco quando a Tab tecla é pressionada é a barra de endereços. Em seguida, os controles na página Web Forms são controlados em ordem crescente, com base no valor da TabIndex propriedade de cada controle, começando pelo menor valor positivo e não zero. Se vários controles compartilharem o mesmo índice de guia, os controles receberão o foco na ordem em que são declarados na página Web Forms. Por fim, os controles que têm um índice de guia zero são acionados na ordem em que são declarados.
Observação
Somente controles com um índice de guia não zero renderizarão o tabindex atributo.
Você pode remover um controle do Servidor Web da ordem de tabulação definindo a TabIndex propriedade como um valor negativo.
Observação
Essa propriedade tem suporte apenas no Internet Explorer 4 e posterior.