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 値のいずれか 1 つ。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. たとえば、をにDock DockStyle.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).

コントロールは、その親コンテナーの1つの端にドッキングできます。または、すべての端にドッキングして、親コンテナーを塗りつぶすことができます。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. 一度に設定できるのは1つだけです。最後の1つのセットが優先されます。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. プロパティのset get メソッドとメソッドの両方をオーバーライドする必要はありません。必要な場合は、1つだけをオーバーライドできます。DockYou are not required to override both the get and set methods of the Dock property; you can override only one if needed.

適用対象

こちらもご覧ください