Control.Dock Свойство

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 . Значение по умолчанию — None.

Исключения

Примеры

В следующем примере кода создается 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 Используйте свойство, чтобы определить, как элемент управления автоматически изменяется по мере изменения размера родительского элемента управления. Например, параметр Dock позволяет DockStyle.Left элементу управления выровняться с левыми краями родительского элемента управления и изменять размер в соответствии с изменением размера родительского элемента управления. Элементы управления закреплены в порядке Z, который является визуальным слоем элементов управления на форме вдоль оси Z формы (глубина).

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

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

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

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

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

• DockStyle
• Anchor
• ScrollableControl.DockPaddingEdges
• Layout