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.

注意

次のコードサンプルでは、単一ファイルのコードモデルを使用して、分離コードファイルに直接コピーした場合、正しく機能しない可能性があります。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 Forms Page Code model」を参照してください。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プロパティの値に基づいて、昇順でタブになります。これは、最小の正の0以外の値から始まります。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.

TabIndexプロパティを負の値に設定することによって、タブオーダーから Web サーバーコントロールを削除できます。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.

適用対象

こちらもご覧ください