Control.Anchor Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Obtiene o establece los bordes del contenedor al que está enlazado un control y determina cómo se cambia el tamaño de un control con su elemento primario.

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

Valor de propiedad

AnchorStyles

Combinación bit a bit de los valores de AnchorStyles. Los valores predeterminados son Top y Left.

Ejemplos

En el ejemplo de código siguiente se agrega un Button objeto a un formulario y se establecen algunas de sus propiedades comunes. En el ejemplo se ancla el botón a la esquina inferior derecha del formulario, por lo que mantiene su posición relativa a medida que se cambia el tamaño del formulario. A continuación, establece y BackgroundImage cambia el tamaño del botón al mismo tamaño que .Image A continuación, el ejemplo establece en TabStoptrue y establece la TabIndex propiedad . Por último, agrega un controlador de eventos para controlar el Click evento del botón. En este ejemplo se requiere que tenga un ImageList objeto denominado 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

Comentarios

Utilice la propiedad para definir cómo se cambia automáticamente el Anchor tamaño de un control a medida que se cambia el tamaño de su control primario. El anclaje de un control a su control primario garantiza que los bordes anclados permanezcan en la misma posición con respecto a los bordes del control primario cuando se cambia el tamaño del control primario.

Puede delimitar un control a uno o varios bordes de su contenedor. Por ejemplo, si tiene un Form con cuyo ButtonAnchor valor de propiedad se establece Top en y Bottom, Button se extiende para mantener la distancia anclada a los bordes superior e inferior de a Form medida que aumenta el HeightForm valor de .

Nota

Las Anchor propiedades y Dock son mutuamente excluyentes. Solo se puede establecer una a la vez y el último conjunto tiene prioridad.

Notas a los desarrolladores de herederos

Al invalidar la Anchor propiedad en una clase derivada, utilice la propiedad de Anchor la clase base para extender la implementación base. De lo contrario, debe proporcionar toda la implementación. No es necesario invalidar los get descriptores de acceso y set de la Anchor propiedad; solo se puede invalidar uno si es necesario.

Consulte también

• AnchorStyles
• Dock
• Layout