Control.Anchor-Eigenschaft

Definieren Sie mit der Anchor-Eigenschaft, wie die Größe eines Steuerelements automatisch geändert wird, sobald die Größe seines übergeordneten Steuerelements geändert wird. Das Verankern eines Steuerelements an seinem übergeordneten Steuerelement stellt sicher, dass bei einer Größenänderung des übergeordneten Steuerelements die verankerten Ränder relativ zu den Rändern des übergeordneten Steuerelements in derselben Position bleiben.

Ein Steuerelement können Sie an einem oder mehreren Rändern des Containers verankern. So wird z. B. bei einem Form mit einem Button, dessen Anchor-Eigenschaftswert auf Top und Bottom festgelegt ist, der Button gestreckt, um den verankerten Abstand zum oberen und unteren Rand des Form beizubehalten, wenn die Height des Form vergrößert wird.

Hinweis
Die Anchor-Eigenschaft und die Dock-Eigenschaft schließen einander gegenseitig aus. Zum gleichen Zeitpunkt kann jeweils nur eine festgelegt werden, und die letzte Gruppe hat Vorrang.

Verwenden Sie beim Überschreiben der Anchor-Eigenschaft in einer abgeleiteten Klasse die Anchor-Eigenschaft der Basisklasse, um die Basisimplementierung zu erweitern. Andernfalls müssen Sie die gesamte Implementierung bereitstellen. Sie müssen nicht sowohl den get-Accessor als auch den set-Accessor der Anchor-Eigenschaft überschreiben. Sie können ggf. auch nur einen Accessor überschreiben.

Im folgenden Codebeispiel wird einem Formular ein Button hinzugefügt, und es werden einige allgemeine Eigenschaften festgelegt. Im Beispiel wird die Schaltfläche in der rechten unteren Ecke des Formulars verankert, sodass sie auch dann ihre relative Position beibehält, wenn die Größe des Formulars geändert wird. Anschließend wird BackgroundImage festgelegt und die Größe der Schaltfläche auf dieselbe Größe wie Image angepasst. Im Beispiel wird TabStop anschließend auf true festgelegt und die TabIndex-Eigenschaft festgelegt. Abschließend wird ein Ereignishandler hinzugefügt, um das Click-Ereignis der Schaltfläche zu behandeln. In diesem Beispiel muss ein ImageList mit der Bezeichnung imageList1 vorhanden sein.

// 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);
}

.NET Framework

.NET Framework Client Profile

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Referenz