WebControl.TabIndex プロパティ

リファレンス

定義

名前空間:: System.Web.UI.WebControls

アセンブリ:: System.Web.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 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

プロパティ値

Int16

Web サーバーコントロールのタブインデックス。既定値は 0 です。このプロパティが設定されていないことを示します。

例外

ArgumentOutOfRangeException

指定したタブインデックスが、-32768 から 32767 の間にありません。

例

次の例では、のプロパティを TabIndex 使用して、ページ上の WebControl コントロールのタブオーダーを設定する方法を示します。

注意

次のコードサンプルでは、単一ファイルコードモデルを使用しており、分離コードファイルに直接コピーすると正しく動作しない場合があります。このコードサンプルは、.aspx拡張子を持つ空のテキストファイルにコピーする必要があります。 Web フォームコードモデルの詳細については、「ASP.NET Web フォームページコードモデル」を参照してください。

重要

この例には、ユーザー入力を受け付けるテキストボックスがあります。これにより、セキュリティが脆弱になる可能性があります。既定では、ASP.NET Web ページによって、ユーザー入力にスクリプトまたは 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 フォームページの Web サーバーコントロールのタブインデックスを指定または決定します。キーを Tab 押すと、Web サーバーコントロールがフォーカスを受け取る順序は、各コントロールのプロパティによって TabIndex 決まります。ページが最初に読み込まれるとき、キーが押されたときにフォーカスを受け取る最初の Tab 項目はアドレスバーです。次に、[Web フォーム] ページのコントロールは、各コントロールのプロパティの値に基づいて、最小の正の 0 以外の TabIndex 値から始まる昇順にタブされます。複数のコントロールが同じタブインデックスを共有する場合、コントロールは Web フォームページで宣言されている順序でフォーカスを受け取ります。最後に、タブインデックスが 0 のコントロールは、宣言された順序でにタブ付けされます。

注意

0 以外のタブインデックスを持つコントロールのみが、属性を tabindex レンダリングします。

プロパティを負の値に設定 TabIndex すると、タブオーダーから Web サーバーコントロールを削除できます。

注意

このプロパティは、Internet Explorer 4 以降でのみサポートされています。

適用対象

次の方法で共有

WebControl.TabIndex プロパティ

定義

プロパティ値

例外

例

注釈

適用対象

こちらもご覧ください

その他のリソース