Control.TabIndex Control.TabIndex Control.TabIndex Control.TabIndex Property

Definition

Ruft die Aktivierreihenfolge des Steuerelements in dessen Container ab oder legt diese fest.Gets or sets the tab order of the control within its container.

public:
 property int TabIndex { int get(); void set(int value); };
public int TabIndex { get; set; }
member this.TabIndex : int with get, set
Public Property TabIndex As Integer

Eigenschaftswert

Der Indexwert des Steuerelements in einer Gruppe von Steuerelementen in dessen Container.The index value of the control within the set of controls within its container. Die Steuerelemente im Container werden in die Aktivierreihenfolge aufgenommen.The controls in the container are included in the tab order.

Beispiele

Im folgenden Codebeispiel wird ein Button zu einem Formular hinzugefügt, und einige der allgemeinen Eigenschaften werden festgelegt.The following code example adds a Button to a form and sets some of its common properties. Im Beispiel wird die Schaltfläche in der unteren rechten Ecke des Formulars verankert, sodass die relative Position bei der Größenänderung des Formulars beibehalten wird.The example anchors the button to the bottom-right corner of the form so it keeps its relative position as the form is resized. Anschließend wird die BackgroundImage festgelegt und die Größe der Schaltfläche auf die gleiche Größe wie die Image festgelegt.Next it sets the BackgroundImage and resizes the button to the same size as the Image. Im Beispiel wird dann der TabStop auf true festgelegt, und die Eigenschaft TabIndex wird festgelegt.The example then sets the TabStop to true and sets the TabIndex property. Schließlich fügt Sie einen Ereignishandler hinzu, der das Click-Ereignis der Schaltfläche behandelt.Lastly, it adds an event handler to handle the Click event of the button. Für dieses Beispiel ist es erforderlich, dass Sie über eine ImageList mit dem Namen imageList1 verfügen.This example requires that you have an ImageList named imageList1.

   // Add a button to a form and set some of its common properties.
private:
   void AddMyButton()
   {
      // Create a button and add it to the form.
      Button^ button1 = gcnew Button;

      // Anchor the button to the bottom right corner of the form
      button1->Anchor = static_cast<AnchorStyles>(AnchorStyles::Bottom | AnchorStyles::Right);

      // Assign a background image.
      button1->BackgroundImage = imageList1->Images[ 0 ];

      // Specify the layout style of the background image. Tile is the default.
      button1->BackgroundImageLayout = ImageLayout::Center;

      // Make the button the same size as the image.
      button1->Size = button1->BackgroundImage->Size;

      // Set the button's TabIndex and TabStop properties.
      button1->TabIndex = 1;
      button1->TabStop = true;

      // Add a delegate to handle the Click event.
      button1->Click += gcnew System::EventHandler( this, &Form1::button1_Click );

      // Add the button to the form.
      this->Controls->Add( button1 );
   }
// Add a button to a form and set some of its common properties.
private void AddMyButton()
{
   // Create a button and add it to the form.
   Button button1 = new Button();

   // Anchor the button to the bottom right corner of the form
   button1.Anchor = (AnchorStyles.Bottom | AnchorStyles.Right);

   // Assign a background image.
   button1.BackgroundImage = imageList1.Images[0];

   // Specify the layout style of the background image. Tile is the default.
   button1.BackgroundImageLayout = ImageLayout.Center;
   
   // Make the button the same size as the image.
   button1.Size = button1.BackgroundImage.Size;

   // Set the button's TabIndex and TabStop properties.
   button1.TabIndex = 1;
   button1.TabStop = true;

   // Add a delegate to handle the Click event.
   button1.Click += new System.EventHandler(this.button1_Click);

   // Add the button to the form.
   this.Controls.Add(button1);
}
' Add a button to a form and set some of its common properties.
Private Sub AddMyButton()
   ' Create a button and add it to the form.
   Dim button1 As New Button()
   
   ' Anchor the button to the bottom right corner of the form
   button1.Anchor = AnchorStyles.Bottom Or AnchorStyles.Right
   
   ' Assign a background image.
   button1.BackgroundImage = imageList1.Images(0)

   ' Specify the layout style of the background image. Tile is the default.
   button1.BackgroundImageLayout = ImageLayout.Center
   
   ' Make the button the same size as the image.
   button1.Size = button1.BackgroundImage.Size
   
   ' Set the button's TabIndex and TabStop properties.
   button1.TabIndex = 1
   button1.TabStop = True

   ' Add a delegate to handle the Click event.
   AddHandler button1.Click, AddressOf Me.button1_Click
   
   ' Add the button to the form.
   Me.Controls.Add(button1)
End Sub

Hinweise

Ein Registerkarten Index kann aus einer beliebigen gültigen Ganzzahl größer oder gleich 0 (null), niedrigeren Zahlen in der Aktivier Reihenfolge bestehen.A tab index can consist of any valid integer greater than or equal to zero, lower numbers being earlier in the tab order. Wenn mehr als ein Steuerelement desselben übergeordneten Steuer Elements denselben Registerkarten Index aufweist, bestimmt die z-Reihenfolge der Steuerelemente die Reihenfolge, in der die Steuerelemente durchlaufen werden.If more than one control on the same parent control has the same tab index, the z-order of the controls determines the order to cycle through the controls.

Damit ein Steuerelement in der Aktivier Reihenfolge enthalten ist, muss die TabStop-Eigenschaft auf true festgelegt werden.For a control to be included in the tab order, its TabStop property must be set to true.

Gilt für:

Siehe auch