Control.Dock Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Windows.Forms
Bütünleştirilmiş Kod:
System.Windows.Forms.dll

Hangi denetim kenarlıklarının üst denetimine yerleştirileceğini alır veya ayarlar ve bir 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 DockStyle biri değil.

Örnekler

Aşağıdaki kod örneği, bir GroupBox oluşturur ve bazı ortak özelliklerini 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ılırken denetimin otomatik olarak nasıl yeniden boyutlandırılacağını tanımlamak için özelliğini kullanın. Örneğin ayarı, Dock DockStyle.Left denetimin kendisini üst denetiminin sol kenarlarıyla hizalamasına ve üst denetim yeniden boyutlandırılırken 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.

Not

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 geçersiz kıldığınızda Dock , 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 ve set yöntemlerini Dock geçersiz kılmanız gerekmez; gerekirse yalnızca birini geçersiz kılabilirsiniz.

Şunlara uygulanır

Ayrıca bkz.