Control.Location Свойство

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Возвращает или задает координаты левого верхнего угла элемента управления относительно левого верхнего угла его контейнера.

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

Значение свойства

Point

Объект Point, представляющий левый верхний угол элемента управления относительно левого верхнего угла контейнера.

Примеры

Следующий пример кода создает GroupBox и задает некоторые из его общих свойств. Этот пример создает TextBox и задает его Location в поле группы. Затем он задает Text свойство поля группы и закрепляет поле группы в верхней части формы. Наконец, он отключает поле группы, задав Enabled для свойства значение false, которое приводит к отключению всех элементов управления, содержащихся в поле группы.

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

Комментарии

Point Поскольку класс является типом значения (Structureв Visual Basic, struct в Visual C#), он возвращается по значению, то есть доступ к свойству возвращает копию верхней левой точки элемента управления. Таким образом, изменение X или свойства возвращаемого Point свойства этого свойства не повлияет на Leftзначения свойств элемента управления, RightTopили Bottom значения Y свойств. Чтобы настроить эти свойства, задайте каждое значение свойства по отдельности Location или задайте новое Pointсвойство.

Если задано Control Formзначение, Location значение свойства представляет верхний левый угол Form координат экрана.

См. также раздел

• Form
• ContainerControl