Control.Dock 속성

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

Source:

Control.cs

부모 컨트롤에 도킹되는 컨트롤 테두리를 가져오거나 설정하며 컨트롤의 크기를 부모 컨트롤과 함께 조정하는 방법을 결정합니다.

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 설정합니다. 이 예제에서는 그룹 상자 내에서 a TextBox 를 만들고 설정합니다 Location . 다음으로 그룹 상자의 속성을 설정하고 Text 그룹 상자를 폼의 맨 위에 도킹합니다. 마지막으로 그룹 상자에 포함된 모든 컨트롤을 사용하지 않도록 설정하는 속성을 false설정하여 그룹 상자를 사용하지 않도록 설정합니다Enabled.

   // 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 크기가 조정될 때 컨트롤의 크기를 자동으로 조정하는 방법을 정의하려면 이 속성을 사용합니다. 예를 들어 컨트롤이 부모 컨트롤의 왼쪽 가장자리에 맞춰지고 부모 컨트롤의 크기가 조정될 때 크기가 조정되도록 설정 DockDockStyle.Left 하면 됩니다. 컨트롤은 폼의 Z축(깊이)을 따라 폼에 있는 컨트롤의 시각적 계층화인 Z 순서로 도킹됩니다.

컨트롤은 부모 컨테이너의 한 가장자리에 도킹되거나 모든 가장자리에 도킹되어 부모 컨테이너를 채울 수 있습니다.

Margin 도킹된 컨트롤에 속성을 설정해도 컨테이너 가장자리에서 컨트롤의 거리에 영향을 주지 않습니다.

메모

및 Anchor 속성은 Dock 상호 배타적입니다. 한 번에 하나만 설정할 수 있으며 마지막 집합이 우선합니다.

상속자 참고

파생 클래스에서 Dock 속성을 재정의하는 경우 기본 클래스의 Dock 속성을 사용하여 기본 구현을 확장합니다. 그렇지 않으면 모든 구현을 제공해야 합니다. 속성의 메서드와 set 메서드를 모두 get 재정의할 필요는 없습니다. 필요한 경우 하나만 재정의 Dock 할 수 있습니다.

추가 정보

• DockStyle
• Anchor
• ScrollableControl.DockPaddingEdges
• Layout