WebControl.TabIndex Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit l’index de tabulation du contrôle serveur 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 ShortValeur de propriété
Index d’onglet du contrôle serveur Web. La valeur par défaut est 0, ce qui indique que cette propriété n’est pas définie.
Exceptions
L’index d’onglet spécifié n’est pas compris entre -32768 et 32767.
Exemples
L’exemple suivant montre comment utiliser la TabIndex propriété de la WebControl propriété pour définir l’ordre de tabulation des contrôles sur la page.
Note
L’exemple de code suivant utilise le modèle de code à fichier unique et peut ne pas fonctionner correctement s’il est copié directement dans un fichier code-behind. Cet exemple de code doit être copié dans un fichier texte vide qui a une extension .aspx. Pour plus d’informations sur le modèle de code Web Forms, consultez ASP.NET modèle de code de page Web Forms.
Important
Cet exemple contient une zone de texte qui accepte l’entrée utilisateur, qui est une menace de sécurité potentielle. Par défaut, ASP.NET pages web valident que l’entrée utilisateur n’inclut pas de script ou d’éléments HTML. Pour plus d’informations, consultez Vue d’ensemble des exploits 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>
Remarques
Utilisez la TabIndex propriété pour spécifier ou déterminer l’index de tabulation d’un contrôle serveur Web sur la page Web Forms. Lorsque vous appuyez sur la Tab touche, l’ordre dans lequel les contrôles serveur Web reçoivent le focus est déterminé par la TabIndex propriété de chaque contrôle. Lorsqu’une page est initialement chargée, le premier élément qui reçoit le focus lorsque la Tab touche est enfoncée est la barre d’adresses. Ensuite, les contrôles de la page Web Forms sont tabulations dans l’ordre croissant, en fonction de la valeur de la TabIndex propriété de chaque contrôle, en commençant par la plus petite valeur positive, différente de zéro. Si plusieurs contrôles partagent le même index d’onglet, les contrôles reçoivent le focus dans l’ordre dans lequel ils sont déclarés sur la page Web Forms. Enfin, les contrôles qui ont un index tabulation de zéro sont tabulations dans l’ordre dans lequel ils sont déclarés.
Note
Seuls les contrôles avec un index de tabulation différent de zéro affichent l’attribut tabindex .
Vous pouvez supprimer un contrôle Serveur Web de l’ordre de tabulation en définissant la TabIndex propriété sur une valeur négative.
Note
Cette propriété est prise en charge uniquement dans Internet Explorer 4 et versions ultérieures.
