WebControl.TabIndex WebControl.TabIndex WebControl.TabIndex WebControl.TabIndex Property

定義

Web サーバー コントロールのタブ インデックスを取得または設定します。Gets or sets the tab index of the Web server control.

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 サーバー コントロールのタブ インデックス。The tab index of the Web server control. 既定値は 0 です。このプロパティが設定されていないことを示します。The default is 0, which indicates that this property is not set.

例外

指定したタブ インデックスが、-32768 から 32767 の間にありません。The specified tab index is not between -32768 and 32767.

次の例を使用する方法を示しています、TabIndexのプロパティ、WebControlページ上のコントロールのタブ オーダーを設定します。The following example illustrates how to use the TabIndex property of the WebControl to set the tab order of controls on the page.

注意

次のコード サンプルでは、1 つのファイル コード モデルを使用して、分離コード ファイルに直接コピーすると、正常に動作しない可能性があります。The following code sample uses the single-file code model and may not work correctly if copied directly into a code-behind file. このコード サンプルは、.aspx 拡張子を持つ空のテキスト ファイルにコピーする必要があります。This code sample must be copied into an empty text file that has an .aspx extension. Web フォームのコード モデルの詳細については、次を参照してください。 ASP.NET Web フォーム ページのコード モデルします。For more information on the Web Forms code model, see ASP.NET Web Forms Page Code Model.

重要

この例には、ユーザー入力を受け付けるテキスト ボックスがあります。これにより、セキュリティが脆弱になる可能性があります。This example has a text box that accepts user input, which is a potential security threat. 既定では、ASP.NET Web ページによって、ユーザー入力にスクリプトまたは HTML 要素が含まれていないかどうかが検証されます。By default, ASP.NET Web pages validate that user input does not include script or HTML elements. 詳細については、「スクリプトによる攻略の概要」を参照してください。For more information, see Script Exploits Overview.

<%@ 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 フォーム ページ上の Web サーバー コントロールのタブ インデックスを確認します。Use the TabIndex property to specify or determine the tab index of a Web server control on the Web Forms page. 押したときに、Tabキー、Web サーバー コントロールにフォーカスが表示される順序が続く、TabIndex各コントロールのプロパティ。When you press the Tab key, the order in which the Web server controls receive focus is determined by the TabIndex property of each control. ページが最初に読み込まれると、最初の項目を受信するフォーカス、Tabキーが押されたはアドレス バーです。When a page is initially loaded, the first item that receives focus when the Tab key is pressed is the address bar. 次に、Web フォーム ページ上のコントロール、タブ付きに、昇順の値に基づいて、TabIndex各コントロールのプロパティ。Next, the controls on the Web Forms page are tabbed to in ascending order, based on the value of the TabIndex property of each control, starting with the smallest positive, nonzero value. 複数のコントロールは、同じタブ インデックスを共有している場合、コントロールは、Web フォーム ページで宣言されている順序でフォーカスを受け取る。If multiple controls share the same tab index, the controls will receive focus in the order they are declared on the Web Forms page. 最後に、0 のタブ インデックスを持つコントロールには、宣言された順序でタブ付き。Finally, controls that have a tab index of zero are tabbed to in the order they are declared.

注意

0 以外のタブ インデックスを持つコントロールのみが表示されます、tabindex属性。Only controls with a nonzero tab index will render the tabindex attribute.

タブ オーダーから Web サーバー コントロールを削除するには設定して、TabIndexプロパティを負の値にします。You can remove a Web Server control from the tab order by setting the TabIndex property to a negative value.

注意

以降では、Internet Explorer 4 のみ、このプロパティがサポートされています。This property is supported only in Internet Explorer 4 and later.

適用対象

こちらもご覧ください