Control.Location Propriedade

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Obtém ou define as coordenadas do canto superior esquerdo do controle com relação ao canto superior esquerdo de seu contêiner.

public:
 property System::Drawing::Point Location { System::Drawing::Point get(); void set(System::Drawing::Point value); };
public System.Drawing.Point Location { get; set; }
member this.Location : System.Drawing.Point with get, set
Public Property Location As Point

Valor da propriedade

Point

O Point que representa o canto superior esquerdo do controle em relação ao canto superior esquerdo do seu contêiner.

Exemplos

O exemplo de código a seguir cria um GroupBox e define algumas de suas propriedades comuns. O exemplo cria um TextBox e define-o Location dentro da caixa de grupo. Em seguida, ele define a Text propriedade da caixa de grupo e encaixa a caixa de grupo na parte superior do formulário. Por fim, ele desabilita a caixa de grupo definindo a propriedade como false, o Enabled que faz com que todos os controles contidos na caixa de grupo sejam desabilitados.

   // Add a GroupBox to a form and set some of its common properties.
private:
   void AddMyGroupBox()
   {
      // Create a GroupBox and add a TextBox to it.
      GroupBox^ groupBox1 = gcnew GroupBox;
      TextBox^ textBox1 = gcnew TextBox;
      textBox1->Location = Point(15,15);
      groupBox1->Controls->Add( textBox1 );

      // Set the Text and Dock properties of the GroupBox.
      groupBox1->Text = "MyGroupBox";
      groupBox1->Dock = DockStyle::Top;

      // Disable the GroupBox (which disables all its child controls)
      groupBox1->Enabled = false;

      // Add the Groupbox to the form.
      this->Controls->Add( groupBox1 );
   }

// Add a GroupBox to a form and set some of its common properties.
private void AddMyGroupBox()
{
   // Create a GroupBox and add a TextBox to it.
   GroupBox groupBox1 = new GroupBox();
   TextBox textBox1 = new TextBox();
   textBox1.Location = new Point(15, 15);
   groupBox1.Controls.Add(textBox1);

   // Set the Text and Dock properties of the GroupBox.
   groupBox1.Text = "MyGroupBox";
   groupBox1.Dock = DockStyle.Top;

   // Disable the GroupBox (which disables all its child controls)
   groupBox1.Enabled = false;

   // Add the Groupbox to the form.
   this.Controls.Add(groupBox1);
}

' Add a GroupBox to a form and set some of its common properties.
Private Sub AddMyGroupBox()
   ' Create a GroupBox and add a TextBox to it.
   Dim groupBox1 As New GroupBox()
   Dim textBox1 As New TextBox()
   textBox1.Location = New Point(15, 15)
   groupBox1.Controls.Add(textBox1)
   
   ' Set the Text and Dock properties of the GroupBox.
   groupBox1.Text = "MyGroupBox"
   groupBox1.Dock = DockStyle.Top
   
   ' Disable the GroupBox (which disables all its child controls)
   groupBox1.Enabled = False
   
   ' Add the Groupbox to the form.
   Me.Controls.Add(groupBox1)
End Sub

Comentários

Como a Point classe é um tipo de valor (Structure no Visual Basic, struct no Visual C#), ela é retornada por valor, o que significa que acessar a propriedade retorna uma cópia do ponto superior esquerdo do controle. Portanto, ajustar as X propriedades ou Y as Point propriedades retornadas dessa propriedade não afetará os Leftvalores de propriedade ou , Rightou Bottom , Topdo controle. Para ajustar essas propriedades, defina cada valor de propriedade individualmente ou defina a Location propriedade com um novo Point.

Se for Control um Form, o valor da Location propriedade representará o canto superior esquerdo das Form coordenadas na tela.

Aplica-se a

Confira também