Control.Dock Свойство

Ссылка

Определение

Пространство имен:: System.Windows.Forms

Сборка:: System.Windows.Forms.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

public:
 virtual property System::Windows::Forms::DockStyle Dock { System::Windows::Forms::DockStyle get(); void set(System::Windows::Forms::DockStyle value); };

public virtual System.Windows.Forms.DockStyle Dock { get; set; }

member this.Dock : System.Windows.Forms.DockStyle with get, set

Public Overridable Property Dock As DockStyle

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

DockStyle

Одно из значений перечисления DockStyle. Значение по умолчанию — None.

Исключения

InvalidEnumArgumentException

Назначенное значение не является одном из значений DockStyle.

Примеры

В следующем примере кода создается 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

Dock Используйте свойство для определения автоматического изменения размера элемента управления при изменении его родительского элемента управления. Например, если задать DockStyle.Left для Dock элемента управления выравнивание по левому краю родительского элемента управления и изменить его размер по мере изменения размера родительского элемента управления. Элементы управления закреплены в порядке Z, который является визуальным слоем элементов управления на форме вдоль оси Z формы (глубина).

Элемент управления можно закрепить на одном краю родительского контейнера или закрепить на всех ребрах и заполнить родительский контейнер.

Margin Установка свойства на закрепленном элементе управления не влияет на расстояние элемента управления от краев контейнера.

Примечание

Свойства Anchor являются Dock взаимоисключающими. Одновременно можно задать только один набор, а последний набор имеет приоритет.

Примечания для тех, кто наследует этот метод

При переопределении Dock свойства в производном классе используйте свойство базового класса Dock для расширения базовой реализации. В противном случае необходимо предоставить всю реализацию. Переопределить get свойство и set методы Dock не требуется. При необходимости можно переопределить только один.

Применяется к