Control.Dock Control.Dock Control.Dock Control.Dock Property

정의

어느 컨트롤 테두리가 부모 컨트롤에 도킹되는지를 가져오거나 설정하고 해당 부모를 기초로 컨트롤 크기를 조정하는 방법을 결정합니다.Gets or sets which control borders are docked to its parent control and determines how a control is resized with its parent.

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 값 중 하나입니다.One of the DockStyle values. 기본값은 None입니다.The default is None.

예외

할당된 값이 DockStyle 값 중 하나가 아닌 경우The value assigned is not one of the DockStyle values.

예제

다음 코드 예제는 GroupBox 해당 공용 속성 중 일부를 설정 합니다.The following code 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

설명

사용 하 여는 Dock 속성 조정 방법을 정의 하려면 컨트롤은 자동으로 부모 컨트롤 크기가 조정 됩니다.Use the Dock property to define how a control is automatically resized as its parent control is resized. 예를 들어, 설정 DockDockStyle.Left 컨트롤이 부모 컨트롤의 왼쪽된 가장자리에 맞춰지고 하는 데 부모 컨트롤의 크기 조정으로 크기를 조정 합니다.For example, setting Dock to DockStyle.Left causes the control to align itself with the left edges of its parent control and to resize as the parent control is resized. 폼의 z 축 (깊이)에 따라 폼에서 컨트롤의 시각적 계층에는 Z 순서에 컨트롤 도킹 됩니다.Controls are docked in their Z-order, which is the visual layering of controls on a form along the form's Z-axis (depth).

해당 부모 컨테이너의 한쪽 가장자리에 도킹 될 수 있습니다 또는 모든 가장자리에 도킹 될 수 있습니다 컨트롤과 부모 컨테이너를 입력 합니다.A control can be docked to one edge of its parent container or can be docked to all edges and fill the parent container.

설정 된 Margin 도킹 된 컨트롤의 속성에 해당 컨테이너의 가장자리에서 컨트롤의 거리에 대 한 영향을 주지 않습니다.Setting the Margin property on a docked control has no effect on the distance of the control from the edges of its container.

참고

합니다 AnchorDock 속성은 함께 사용할 수 없습니다.The Anchor and Dock properties are mutually exclusive. 한 번에 하나만 설정할 수 있습니다 하 고 우선적으로 마지막으로 설정 합니다.Only one can be set at a time, and the last one set takes precedence.

상속자 참고

재정의 하는 경우는 Dock 기본 클래스를 사용 하는 파생된 클래스에서 속성 Dock 속성을 기본 구현을 확장 합니다.When overriding the Dock property in a derived class, use the base class's Dock property to extend the base implementation. 그렇지 않으면 전체 구현을 제공 해야 합니다.Otherwise, you must provide all the implementation. 모두 재정의할 필요가 없습니다를 get 하 고 set 의 메서드는 Dock 속성 필요한 경우 하나만 재정의할 수 있습니다.You are not required to override both the get and set methods of the Dock property; you can override only one if needed.

적용 대상

추가 정보