Control.Anchor Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Возвращает или задает границы контейнера, с которым связан элемент управления, и определяет способ изменения размеров элемента управления при изменении размеров его родительского элемента.

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

Значение свойства

AnchorStyles

Поразрядное сочетание значений AnchorStyles. Значения по умолчанию — Top и Left.

Примеры

В следующем примере кода добавляется Button в форму и задаются некоторые из ее общих свойств. В примере кнопка привязывается к правому нижнему углу формы, чтобы она сохраняла ее относительное положение при изменении размера формы. Затем он задает BackgroundImage и изменяет размер кнопки до того же размера, что Imageи . Затем в примере задается TabStop значение true и свойство TabIndex . Наконец, он добавляет обработчик событий для обработки Click события кнопки. Для этого примера требуется , чтобы у вас был с ImageList именем 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

Комментарии

Используйте свойство , Anchor чтобы определить, как автоматически изменяется размер элемента управления при изменении размера его родительского элемента управления. Привязка элемента управления к родительскому элементу управления гарантирует, что при изменении размера родительского элемента управления привязанные края остаются в той же позиции относительно краев родительского элемента управления.

Элемент управления можно привязать к одному или нескольким краям его контейнера. Например, если у вас есть Form объект с свойством Button , свойство которого Anchor имеет Top значение и Bottom, Button объект растягивается для сохранения привязанного расстояния до верхнего и нижнего краев объекта по Form мере HeightForm увеличения .

Примечание

Anchor Свойства и Dock являются взаимоисключающими. Одновременно можно задать только один набор, и последний набор имеет приоритет.

Примечания для тех, кто наследует этот метод

При переопределении Anchor свойства в производном классе используйте свойство базового класса Anchor , чтобы расширить базовую реализацию. В противном случае необходимо предоставить всю реализацию. Не требуется переопределять методы getAnchor доступа и set свойства. При необходимости можно переопределить только один метод.

См. также раздел

• AnchorStyles
• Dock
• Layout