Поделиться через

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 не требуется. При необходимости можно переопределить только один.

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

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