Control.Location Eigenschaft

  • Referenz

Definition

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

Ruft die Koordinaten der linken oberen Ecke des Steuerelements relativ zur linken oberen Ecke des Containers ab oder legt diese fest.

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

Eigenschaftswert

Point

Der Point, der die linke obere Ecke des Steuerelements relativ zur linken oberen Ecke des Containers darstellt.

Beispiele

Im folgenden Codebeispiel werden einige GroupBox der allgemeinen Eigenschaften erstellt und festgelegt. Im Beispiel wird ein TextBox Objekt erstellt und im Location Gruppenfeld festgelegt. Als Nächstes wird die Text Eigenschaft des Gruppenfelds festgelegt und das Gruppenfeld am oberen Rand des Formulars angedockt. Schließlich deaktiviert sie das Gruppenfeld, indem Sie die Enabled Eigenschaft falsefestlegen, was dazu führt, dass alle Steuerelemente im Gruppenfeld deaktiviert werden.

   // 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

Hinweise

Da die Point Klasse ein Werttyp (Structure in Visual Basic, struct in Visual C#) ist, wird sie nach Wert zurückgegeben, d. h. der Zugriff auf die Eigenschaft gibt eine Kopie des oberen linken Punkts des Steuerelements zurück. Die Anpassung der von dieser Eigenschaft zurückgegebenen Eigenschaften wirkt sich also nicht auf die X Y LeftWerte Rightdes Steuerelements, TopBottom oder die Eigenschaftenwerte Point aus. Um diese Eigenschaften anzupassen, legen Sie jeden Eigenschaftswert einzeln fest, oder legen Sie die Location Eigenschaft mit einem neuen PointFest fest.

Wenn es Control sich um einen FormWert handelt, stellt der Eigenschaftswert die Location obere linke Ecke der Form in Bildschirmkoordinaten dargestellten Bildschirmkoordinaten dar.

Gilt für

Siehe auch