WebControl.TabIndex プロパティ

[アーティクル]
03/28/2008

Web サーバーコントロールのタブインデックスを取得または設定します。

Public Overridable Property TabIndex As Short
[C#]
public virtual short TabIndex {get; set;}
[C++]
public: __property virtual short get_TabIndex();public: __property virtual void set_TabIndex(short);
[JScript]
public function get TabIndex() : Int16;public function set TabIndex(Int16);

プロパティ値

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

例外

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

解説

TabIndex プロパティを使用して、Web フォームページ上の Web サーバーコントロールのタブインデックスを指定または確認します。 Tab キーを押したときの、Web サーバーコントロールがフォーカスを受け取る順序は、各コントロールの TabIndex プロパティによって決定されます。ページが最初に読み込まれるとき、 Tab キーが押されて最初にフォーカスを受け取る項目はアドレスバーです。次に、各コントロールの TabIndex プロパティの値に基づいて、Web フォームページのコントロール間を Tab キーで昇順に移動します。Tab キーによる移動は、0 以外の最小の正の値から開始されます。複数のコントロールが同じタブインデックスを共有している場合、コントロールは、Web フォームページで宣言されている順序でフォーカスを受け取ります。最後に、0 のタブインデックスを持つコントロール間を宣言された順序で Tab キーにより移動します。

メモ 0 以外のタブインデックスのあるコントロールにだけ tabindex 属性が表示されます。

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

メモこのプロパティは、Internet Explorer 4 以降でだけサポートされます。

使用例

[Visual Basic, C#, JScript] WebControl の TabIndex プロパティを使用して、ページ上のコントロールのタブオーダーを設定する方法の例を次に示します。

 
<%@ Page Language="VB" AutoEventWireup="True" %>

<html>
 <body>
     <h3>TabIndex Property of a Web Control<br></h3>
 
 <script Language="VB" 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>
 
 <form runat=server>
 
     Type in the numbers 1, 2, or 3 as the desired tab order 
     for the following text boxes, <br> 
     Click the Submit button, and <br> 
     Tab through the text boxes to verify:<p>
 
     <asp:Button id="SubmitBtn1" OnClick="SubmitBtn1_Click" Text="Submit" runat="server"/>
     <p>
 
     <asp:TextBox id="TextBox1" BackColor="Pink" runat="server"/>
     <p>
 
     <asp:TextBox id="TextBox2" BackColor="LightBlue" runat="server"/>
     <p>
 
     <asp:TextBox id="TextBox3" BackColor="LightGreen" runat="server"/>
     <p>  
     
 </form>
 
 </body>
 </html>


[C#] 
<%@ Page Language="C#" AutoEventWireup="True" %>

<html>
 <body>
     <h3>TabIndex Property of a Web Control<br></h3>
 
 <script Language="C#" 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>
 
 <form runat=server>
 
     Type in the numbers 1, 2, or 3 as the desired tab order 
     for the following text boxes, <br> 
     Click the Submit button, and <br> 
     Tab through the text boxes to verify:<p>
 
     <asp:Button id="SubmitBtn1" OnClick="SubmitBtn1_Click" Text="Submit" runat="server"/>
     <p>
 
     <asp:TextBox id="TextBox1" BackColor="Pink" runat="server"/>
     <p>
 
     <asp:TextBox id="TextBox2" BackColor="LightBlue" runat="server"/>
     <p>
 
     <asp:TextBox id="TextBox3" BackColor="LightGreen" runat="server"/>
     <p>  
     
 </form>
 
 </body>
 </html>


[JScript] 
<%@ Page Language="JScript" AutoEventWireup="True" %>

<html>
 <body>
     <h3>TabIndex Property of a Web Control<br></h3>
 
 <script Language="JSCRIPT" runat="server">
 
    function SubmitBtn1_Click(sender : Object, e : EventArgs){
        SubmitBtn1.TabIndex = 0
        if(TextBox1.Text == "")
            TextBox1.TabIndex = 0
        else
            TextBox1.TabIndex = System.Int16.Parse(TextBox1.Text)
        if(TextBox2.Text == "")
            TextBox2.TabIndex = 0
        else
            TextBox2.TabIndex = System.Int16.Parse(TextBox2.Text)
        if(TextBox3.Text == "")
            TextBox3.TabIndex = 0
        else
            TextBox3.TabIndex = System.Int16.Parse(TextBox3.Text)
    }
 
 </script>
 
 <form runat=server>
 
     Type in the numbers 1, 2, or 3 : the desired tab order 
     for the following text boxes, <br> 
     Click the Submit button, and <br> 
     Tab through the text boxes to verify:<p>
 
     <asp:Button id="SubmitBtn1" OnClick="SubmitBtn1_Click" Text="Submit" runat="server"/>
     <p>
 
     <asp:TextBox id="TextBox1" BackColor="Pink" runat="server"/>
     <p>
 
     <asp:TextBox id="TextBox2" BackColor="LightBlue" runat="server"/>
     <p>
 
     <asp:TextBox id="TextBox3" BackColor="LightGreen" runat="server"/>
     <p>  
     
 </form>
 
 </body>
 </html>

[C++] C++ のサンプルはありません。Visual Basic、C#、および JScript のサンプルを表示するには、このページの左上隅にある言語のフィルタボタンをクリックします。

必要条件

プラットフォーム: Windows 2000, Windows XP Professional, Windows Server 2003 ファミリ

参照

WebControl クラス | WebControl メンバ | System.Web.UI.WebControls 名前空間

WebControl.TabIndex プロパティ

プロパティ値

例外

解説

使用例

必要条件

参照

その他のリソース