DockStyle DockStyle DockStyle DockStyle Enum

Определение

Задает позицию и способ закрепления элемента управления.Specifies the position and manner in which a control is docked.

public enum class DockStyle
public enum DockStyle
type DockStyle = 
Public Enum DockStyle
Наследование

Поля

Bottom Bottom Bottom Bottom 2

Нижний край элемента управления закрепляется в нижней части содержащего его элемента управления.The control's bottom edge is docked to the bottom of its containing control.

Fill Fill Fill Fill 5

Все края элемента управления закрепляются у краев содержащего его элемента управления, а их размеры изменяются соответствующим образом.All the control's edges are docked to the all edges of its containing control and sized appropriately.

Left Left Left Left 3

Левый край элемента управления закрепляется в левой части содержащего его элемента управления.The control's left edge is docked to the left edge of its containing control.

None None None None 0

Элемент управления не закреплен.The control is not docked.

Right Right Right Right 4

Правый край элемента управления закрепляется в правой части содержащего его элемента управления.The control's right edge is docked to the right edge of its containing control.

Top Top Top Top 1

Верхний край элемента управления закрепляется в верхней части содержащего его элемента управления.The control's top edge is docked to the top of its containing control.

Примеры

В следующем примере создается GroupBox и задаются некоторые общие свойства.The following example creates a GroupBox and sets some of its common properties. В примере создается TextBox и Location задается в поле группы.The example creates a TextBox and sets its Location within the group box. Затем задается Text свойство поля группы и закрепляет поле группы в верхней части формы.Next, it sets the Text property of the group box, and docks the group box to the top of the form. Наконец, он отключает поле группы, присвоив Enabled falseсвойству значение, которое приводит к отключению всех элементов управления, содержащихся в поле группы.Lastly, it disables the group box by setting the Enabled property to false, which causes all controls contained within the group box to be disabled.

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

Комментарии

Когда элемент управления закрепляется на границе своего контейнера, он всегда позиционируется на эту сторону при изменении размера контейнера.When a control is docked to an edge of its container, it is always positioned flush against that edge when the container is resized. Если к границе прикрепляется несколько элементов управления, то элементы управления отображаются рядом в соответствии с их z-порядком; элементы управления, расположенные выше в z-порядке, располагаются дальше от границы контейнера.If more than one control is docked to an edge, the controls appear side by side according to their z-order; controls higher in the z-order are positioned farther from the container's edge.

Если выбрано левое, правое, верхнее или нижнее, то размеры указанного и противоположного края элемента управления изменяются в соответствии с размерами соответствующих границ элемента управления.If Left, Right, Top, or Bottom is selected, the specified and opposite edges of the control are resized to the size of the containing control's corresponding edges. Если выбран параметр Fill, размеры всех четырех сторон элемента управления изменяются в соответствии с краями содержащего его элемента управления.If Fill is selected, all four sides of the control are resized to match the containing control's edges.

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

Дополнительно