Control.Anchor Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

Control.cs

Získá nebo nastaví hrany kontejneru, ke kterému je ovládací prvek vázán a určuje, jak je ovládací prvek změněn s jeho nadřazeným objektem.

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

Hodnota vlastnosti

AnchorStyles

Bitové kombinace AnchorStyles hodnot. Výchozí hodnota je Top a Left.

Příklady

Následující příklad kódu přidá Button do formuláře a nastaví některé její společné vlastnosti. Příklad ukotvení tlačítka do pravého dolního rohu formuláře, aby při změně velikosti formuláře zachová jeho relativní pozici. Dále nastaví BackgroundImage tlačítko a změní velikost tlačítka na stejnou velikost jako Image. Příklad pak nastaví TabStop na true a nastaví TabIndex vlastnost. Nakonec přidá obslužnou rutinu události pro zpracování Click události tlačítka. Tento příklad vyžaduje, abyste měli ImageList název 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

Poznámky

Anchor Pomocí vlastnosti můžete definovat, jak se ovládací prvek automaticky změní, protože se změní velikost jeho nadřazeného ovládacího prvku. Ukotvení ovládacího prvku na nadřazený ovládací prvek zajistí, že ukotvené hrany zůstanou ve stejné pozici vzhledem k okrajům nadřazeného ovládacího prvku při změně velikosti nadřazeného ovládacího prvku.

Ovládací prvek můžete ukotvit na jeden nebo více okrajů jeho kontejneru. Pokud máte Form například s AnchorButton hodnotou vlastnosti nastavenou Top hodnotu a Bottom, je roztažena tak, Button aby se zachovala ukotvená vzdálenost k horním a dolním okraji horního a dolního FormHeight okraje při zvýšení hodnotyForm.

Poznámka:

Vlastnosti Anchor se Dock vzájemně vylučují. Najednou lze nastavit pouze jednu a poslední sada má přednost.

Poznámky pro dědice

Při přepsání Anchor vlastnosti v odvozené třídě použijte vlastnost základní třídy Anchor k rozšíření základní implementace. V opačném případě musíte zadat veškerou implementaci. Není nutné přepsat jak objekty getset , tak přístupové objekty Anchor vlastnosti. V případě potřeby můžete přepsat pouze jeden.

Viz také

• AnchorStyles
• Dock
• Layout