Control.Dock Özellik

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

Control.cs

Hangi denetim kenarlıklarının üst denetimine yerleştirileceğini alır veya ayarlar ve denetimin üst denetimiyle nasıl yeniden boyutlandırıldığını belirler.

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

Özellik Değeri

DockStyle

Değerlerden DockStyle biri. Varsayılan değer: None.

Özel durumlar

InvalidEnumArgumentException

Atanan değer değerlerden biri DockStyle değildir.

Örnekler

Aşağıdaki kod örneği, bir GroupBox oluşturur ve ortak özelliklerinden bazılarını ayarlar. Örnek, grup kutusu içinde bir TextBox oluşturur ve ayarlar Location . Ardından, grup kutusunun özelliğini ayarlar Text ve grup kutusunu formun en üstüne sabitler. Son olarak, özelliğini falseolarak ayarlayarak Enabled grup kutusunu devre dışı bırakır ve bu da grup kutusunun içindeki tüm denetimlerin devre dışı bırakılmasına neden olur.

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

Açıklamalar

Dock Üst denetimi yeniden boyutlandırıldıkçe denetimin otomatik olarak nasıl yeniden boyutlandırılacağını tanımlamak için özelliğini kullanın. Örneğin ayarı, DockDockStyle.Left denetimin kendisini üst denetimin sol kenarlarıyla hizalamasına ve üst denetim yeniden boyutlandırıldıkçe yeniden boyutlandırmasına neden olur. Denetimler, formun Z ekseni (derinlik) boyunca bir formdaki denetimlerin görsel katmanlanması olan Z sıralarına yerleştirilir.

Denetim, üst kapsayıcısının bir kenarına sabitlenebilir veya tüm kenarlara yerleştirilip üst kapsayıcıyı doldurabilir.

Yerleşik denetimde özelliğinin Margin ayarlanması, denetimin kapsayıcısının kenarlarından uzaklığını etkilemez.

Uyarı

Anchor ve Dock özellikleri birbirini dışlar. Aynı anda yalnızca bir küme ayarlanabilir ve son küme önceliklidir.

Devralanlara Notlar

Türetilmiş bir sınıfta özelliğini Dock geçersiz kıldığınızda temel uygulamanın kapsamını genişletmek için temel sınıfın Dock özelliğini kullanın. Aksi takdirde, tüm uygulamayı sağlamanız gerekir. Özelliğin get hem hem set de yöntemlerini Dock geçersiz kılmanız gerekmez; gerekirse yalnızca birini geçersiz kılabilirsiniz.

Ayrıca bkz.

• DockStyle
• Anchor
• ScrollableControl.DockPaddingEdges
• Layout