WebControl.TabIndex 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取或设置 Web 服务器控件的选项卡索引。
public:
virtual property short TabIndex { short get(); void set(short value); };
public virtual short TabIndex { get; set; }
member this.TabIndex : int16 with get, set
Public Overridable Property TabIndex As Short
属性值
Web 服务器控件的选项卡索引。 默认值为 0
,指示未设置此属性。
例外
指定的选项卡索引不在 -32768 和 32767 之间。
示例
下面的示例演示如何使用 TabIndex 属性 WebControl 设置页面上控件的 Tab 键顺序。
备注
下面的代码示例使用单文件代码模型,如果直接复制到代码隐藏文件中,可能无法正常工作。 必须将此代码示例复制到具有 .aspx 扩展名的空文本文件中。 有关Web Forms代码模型的详细信息,请参阅 ASP.NET Web Forms页代码模型。
重要
此示例具有一个接受用户输入的文本框,这是一个潜在的安全威胁。 默认情况下,ASP.NET 网页验证用户输入是否不包含脚本或 HTML 元素。 有关详细信息,请参阅脚本侵入概述。
<%@ 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>
注解
使用属性TabIndex可指定或确定Web Forms页上 Web 服务器控件的选项卡索引。 按 Tab
键时,Web 服务器控件接收焦点的顺序由 TabIndex 每个控件的属性确定。 最初加载页面时,按下键时 Tab
接收焦点的第一项是地址栏。 接下来,Web Forms页上的控件按升序按升序排列,具体取决于每个控件的属性的值TabIndex,从最小正值和非零值开始。 如果多个控件共享同一选项卡索引,控件将按在Web Forms页上声明的顺序接收焦点。 最后,具有零的制表符索引的控件按其声明顺序进行制表符。
备注
只有具有非零制表位索引的控件才会呈现 tabindex
该属性。
可以通过将 TabIndex 属性设置为负值,从 Tab 键顺序中删除 Web 服务器控件。
备注
此属性仅在 Internet Explorer 4 及更高版本中受支持。