Control.Anchor Eigenschap

Definitie

Naamruimte:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Hiermee haalt of stelt u de randen van de container op waaraan een besturingselement is gebonden en bepaalt u hoe het formaat van een besturingselement wordt gewijzigd met het bovenliggende besturingselement.

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

Waarde van eigenschap

AnchorStyles

Een bitsgewijze combinatie van de AnchorStyles waarden. De standaardwaarde is Top en Left.

Voorbeelden

In het volgende codevoorbeeld wordt een Button formulier toegevoegd en worden enkele algemene eigenschappen ervan ingesteld. In het voorbeeld wordt de knop in de rechterbenedenhoek van het formulier verankerd, zodat de relatieve positie behouden blijft wanneer het formulier wordt gewijzigd. Vervolgens stelt u de knop in BackgroundImage en wijzigt u de grootte van de knop op dezelfde grootte als de Image. In het voorbeeld wordt vervolgens de TabStopTabIndex eigenschap ingesteld true op en ingesteld. Ten slotte wordt er een gebeurtenis-handler toegevoegd om de Click gebeurtenis van de knop af te handelen. In dit voorbeeld moet u een ImageList naam imageList1hebben.

   // 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

Opmerkingen

Gebruik de Anchor eigenschap om te definiëren hoe het formaat van een besturingselement automatisch wordt gewijzigd wanneer het bovenliggende besturingselement wordt gewijzigd. Als u een besturingselement aan het bovenliggende besturingselement verankert, zorgt u ervoor dat de verankerde randen op dezelfde positie blijven ten opzichte van de randen van het bovenliggende besturingselement wanneer het bovenliggende besturingselement wordt gewijzigd.

U kunt een besturingselement aan een of meer randen van de container verankeren. Als u bijvoorbeeld een Form eigenschapswaarde hebt waarvan ButtonAnchor de eigenschapswaarde is ingesteld Top op en Bottom, wordt deze Button uitgerekt om de verankerde afstand tot de boven- en onderranden van de Form boven- en onderrand te behouden wanneer de waarde van de HeightForm eigenschap wordt verhoogd.

Note

De Anchor en Dock eigenschappen sluiten elkaar wederzijds uit. Er kan slechts één tegelijk worden ingesteld en de laatste set heeft voorrang.

Notities voor overnemers

Wanneer u de Anchor eigenschap in een afgeleide klasse overschrijft, gebruikt u de eigenschap van Anchor de basisklasse om de basis-implementatie uit te breiden. Anders moet u alle implementaties opgeven. U hoeft niet zowel de getset eigenschap als de Anchor toegangsrechten te overschrijven. U kunt er slechts één overschrijven als dat nodig is.

Zie ook

• AnchorStyles
• Dock
• Layout