Control.Bounds Propriedade

Definição

Obtém ou define o tamanho e a localização do controle, inclusive seus elementos que não são destinados ao cliente, em pixels, relativos ao controle pai.Gets or sets the size and location of the control including its nonclient elements, in pixels, relative to the parent control.

public:
 property System::Drawing::Rectangle Bounds { System::Drawing::Rectangle get(); void set(System::Drawing::Rectangle value); };
[System.ComponentModel.Browsable(false)]
public System.Drawing.Rectangle Bounds { get; set; }
member this.Bounds : System.Drawing.Rectangle with get, set
Public Property Bounds As Rectangle

Valor da propriedade

Um Rectangle em pixels relativo ao controle pai que representa o tamanho e a localização do controle, inclusive seus elementos que não são destinados ao cliente.A Rectangle in pixels relative to the parent control that represents the size and location of the control including its nonclient elements.

Atributos

Exemplos

O exemplo de código a seguir cria três Button controles em um formulário e define seu tamanho e local usando as várias propriedades relacionadas ao tamanho e ao local.The following code example creates three Button controls on a form and sets their size and location by using the various size-related and location-related properties. Este exemplo requer que você tenha uma Form que tenha uma largura e uma altura de pelo menos 300 pixels.This example requires that you have a Form that has a width and height of at least 300 pixels.

// Create three buttons and place them on a form using
// several size and location related properties.
void AddOKCancelButtons()
{
   
   // Set the button size and location using
   // the Size and Location properties.
   Button^ buttonOK = gcnew Button;
   buttonOK->Location = Point(136,248);
   buttonOK->Size = System::Drawing::Size( 75, 25 );
   
   // Set the Text property and make the
   // button the form's default button.
   buttonOK->Text = "&OK";
   this->AcceptButton = buttonOK;
   
   // Set the button size and location using the Top,
   // Left, Width, and Height properties.
   Button^ buttonCancel = gcnew Button;
   buttonCancel->Top = buttonOK->Top;
   buttonCancel->Left = buttonOK->Right + 5;
   buttonCancel->Width = buttonOK->Width;
   buttonCancel->Height = buttonOK->Height;
   
   // Set the Text property and make the
   // button the form's cancel button.
   buttonCancel->Text = "&Cancel";
   this->CancelButton = buttonCancel;
   
   // Set the button size and location using
   // the Bounds property.
   Button^ buttonHelp = gcnew Button;
   buttonHelp->Bounds = Rectangle(10,10,75,25);
   
   // Set the Text property of the button.
   buttonHelp->Text = "&Help";
   
   // Add the buttons to the form.
   array<Control^>^temp1 = {buttonOK,buttonCancel,buttonHelp};
   this->Controls->AddRange( temp1 );
}
// Create three buttons and place them on a form using 
// several size and location related properties. 
private void AddOKCancelButtons()
{
   // Set the button size and location using 
   // the Size and Location properties.
   Button buttonOK = new Button();
   buttonOK.Location = new Point(136,248);
   buttonOK.Size = new Size(75,25);
   // Set the Text property and make the 
   // button the form's default button. 
   buttonOK.Text = "&OK";
   this.AcceptButton = buttonOK;

   // Set the button size and location using the Top, 
   // Left, Width, and Height properties.
   Button buttonCancel = new Button();
   buttonCancel.Top = buttonOK.Top;
   buttonCancel.Left = buttonOK.Right + 5;
   buttonCancel.Width = buttonOK.Width;
   buttonCancel.Height = buttonOK.Height;
   // Set the Text property and make the 
   // button the form's cancel button.
   buttonCancel.Text = "&Cancel";
   this.CancelButton = buttonCancel;

   // Set the button size and location using 
   // the Bounds property.
   Button buttonHelp = new Button();
   buttonHelp.Bounds = new Rectangle(10,10, 75, 25);
   // Set the Text property of the button.
   buttonHelp.Text = "&Help";

   // Add the buttons to the form.
   this.Controls.AddRange(new Control[] {buttonOK, buttonCancel, buttonHelp} );
}
' Create three buttons and place them on a form using 
' several size and location related properties. 
Private Sub AddOKCancelButtons()
   ' Set the button size and location using 
      ' the Size and Location properties. 
   Dim buttonOK As New Button()
   buttonOK.Location = New Point(136, 248)
   buttonOK.Size = New Size(75, 25)
   ' Set the Text property and make the 
   ' button the form's default button. 
   buttonOK.Text = "&OK"
   Me.AcceptButton = buttonOK
   
   ' Set the button size and location using the Top, 
   ' Left, Width, and Height properties. 
   Dim buttonCancel As New Button()
   buttonCancel.Top = buttonOK.Top
   buttonCancel.Left = buttonOK.Right + 5
   buttonCancel.Width = buttonOK.Width
   buttonCancel.Height = buttonOK.Height
   ' Set the Text property and make the 
   ' button the form's cancel button. 
   buttonCancel.Text = "&Cancel"
   Me.CancelButton = buttonCancel
   
   ' Set the button size and location using 
   ' the Bounds property. 
   Dim buttonHelp As New Button()
   buttonHelp.Bounds = New Rectangle(10, 10, 75, 25)
   ' Set the Text property of the button.
   buttonHelp.Text = "&Help"
   
   ' Add the buttons to the form.
   Me.Controls.AddRange(New Control() {buttonOK, buttonCancel, buttonHelp})
End Sub

Comentários

Os limites do controle incluem os elementos que não são do cliente, como barras de rolagem, bordas, barras de título e menus.The bounds of the control include the nonclient elements such as scroll bars, borders, title bars, and menus. O método SetBoundsCore é chamado para definir a propriedade Bounds.The SetBoundsCore method is called to set the Bounds property. A propriedade Bounds nem sempre é alterada por meio de seu método set, portanto, você deve substituir o método SetBoundsCore para garantir que o código seja executado quando a propriedade Bounds for definida.The Bounds property is not always changed through its set method so you should override the SetBoundsCore method to ensure that your code is executed when the Bounds property is set.

Aplica-se a

Veja também