AnchorStyles Enumeração

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Especifica como um controle é ancorado às bordas de seu contêiner.

Essa enumeração dá suporte a uma combinação bit a bit dos valores de membro.

public enum class AnchorStyles

[System.Flags]
public enum AnchorStyles

[<System.Flags>]
type AnchorStyles = 

Public Enum AnchorStyles

Herança

Object

ValueType

Enum

AnchorStyles

Atributos

FlagsAttribute

Campos

Bottom	2	O controle é ancorado na borda inferior de seu contêiner.
Left	4	O controle é ancorado na borda esquerda de seu contêiner.
None	0	O controle não é ancorado a nenhuma borda de seu contêiner.
Right	8	O controle é ancorado na borda direita de seu contêiner.
Top	1	O controle é ancorado na borda superior de seu contêiner.

Exemplos

O exemplo a seguir adiciona um Button a um formulário e define algumas de suas propriedades comuns. O exemplo ancora o botão no canto inferior direito do formulário para que ele mantenha sua posição relativa à medida que o formulário é redimensionado. Em seguida, ele define o BackgroundImage e redimensiona o botão para o mesmo tamanho que o Image. Em seguida, o exemplo define como TabStoptrue e define a TabIndex propriedade . Por fim, ele adiciona um manipulador de eventos para manipular o Click evento do botão. Este exemplo pressupõe que você tenha um ImageList chamado 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

Comentários

Quando um controle é ancorado em uma borda de seu contêiner, a distância entre o controle e a borda especificada permanece constante quando o contêiner é redimensionado. Por exemplo, se um controle for ancorado na borda direita de seu contêiner, a distância entre a borda direita do controle e a borda direita do contêiner permanecerá constante quando o contêiner for redimensionado. Um controle pode ser ancorado em qualquer combinação de bordas de controle. Se o controle estiver ancorado em bordas opostas de seu contêiner (por exemplo, na parte superior e inferior), ele será redimensionado quando o contêiner for redimensionado. Se um controle tiver sua Anchor propriedade definida como Nenhum, o controle moverá metade da distância que o contêiner do controle é redimensionado. Por exemplo, se um Button tiver sua Anchor propriedade definida como Nenhum e o Form em que o controle está localizado for redimensionado por 20 pixels em qualquer direção, o botão será movido 10 pixels em ambas as direções.

Confira também

• Anchor