Control.Anchor Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft die Ränder des Containers ab, an die ein Steuerelement gebunden ist, oder legt diese fest und bestimmt, wie die Größe des Steuerelements mit dessen übergeordnetem Element geändert wird.

public:
 virtual property System::Windows::Forms::AnchorStyles Anchor { System::Windows::Forms::AnchorStyles get(); void set(System::Windows::Forms::AnchorStyles value); };

public virtual System.Windows.Forms.AnchorStyles Anchor { get; set; }

member this.Anchor : System.Windows.Forms.AnchorStyles with get, set

Public Overridable Property Anchor As AnchorStyles

Eigenschaftswert

AnchorStyles

Eine bitweise Kombination der AnchorStyles-Werte. Der Standardwert ist Top und Left.

Beispiele

Im folgenden Codebeispiel wird einem Formular ein Button hinzugefügt und einige der allgemeinen Eigenschaften festgelegt. Im Beispiel wird die Schaltfläche in der unteren rechten Ecke des Formulars verankert, sodass sie ihre relative Position behält, wenn die Größe des Formulars geändert wird. Als Nächstes legt er die BackgroundImage Schaltfläche fest und ändert die Größe der Schaltfläche auf die gleiche Größe wie .Image Das Beispiel legt dann auf TabStop fest und true legt die TabIndex -Eigenschaft fest. Zuletzt wird ein Ereignishandler hinzugefügt, um das Click Ereignis der Schaltfläche zu behandeln. Dieses Beispiel erfordert, dass Sie über einen ImageList namens verfügen 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

Verwenden Sie die Anchor -Eigenschaft, um zu definieren, wie die Größe eines Steuerelements automatisch geändert wird, wenn die Größe des übergeordneten Steuerelements geändert wird. Durch Verankern eines Steuerelements am übergeordneten Steuerelement wird sichergestellt, dass die verankerten Kanten relativ zu den Kanten des übergeordneten Steuerelements in derselben Position verbleiben, wenn die Größe des übergeordneten Steuerelements geändert wird.

Sie können ein Steuerelement an mindestens einem Rand des Containers verankern. Wenn Sie beispielsweise einen mit einem Form Button haben, dessen Anchor Eigenschaftswert auf Top und Bottomfestgelegt ist, wird der Button gestreckt, um den verankerten Abstand zum oberen und unteren Rand des Form beizubehalten, da der Height von Form erhöht ist.

Hinweis

Die Anchor Eigenschaften und Dock schließen sich gegenseitig aus. Nur eine kann gleichzeitig festgelegt werden, und der letzte Satz hat Vorrang.

Hinweise für Vererber

Verwenden Sie beim Überschreiben der Anchor -Eigenschaft in einer abgeleiteten Klasse die -Eigenschaft der Basisklasse Anchor , um die Basisimplementierung zu erweitern. Andernfalls müssen Sie die gesamte Implementierung bereitstellen. Sie müssen nicht sowohl die Accessoren als set auch die get Accessoren der Anchor Eigenschaft außer Kraft setzen. Sie können bei Bedarf nur einen überschreiben.

Gilt für:

Freigeben über