Control.Dock Properti

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Sumber:

Control.cs

Mendapatkan atau mengatur batas kontrol mana yang ditautkan ke kontrol induknya dan menentukan bagaimana kontrol diubah ukurannya dengan induknya.

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

Nilai Properti

DockStyle

Salah DockStyle satu nilai. Defaultnya adalah None.

Pengecualian

InvalidEnumArgumentException

Nilai yang ditetapkan bukan salah DockStyle satu nilai.

Contoh

Contoh kode berikut membuat GroupBox dan mengatur beberapa properti umumnya. Contoh membuat TextBox dan mengaturnya Location dalam kotak grup. Selanjutnya, ini mengatur Text properti kotak grup, dan menambungkan kotak grup ke bagian atas formulir. Terakhir, ini menonaktifkan kotak grup dengan mengatur Enabled properti ke false, yang menyebabkan semua kontrol yang terkandung dalam kotak grup dinonaktifkan.

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

Keterangan

Dock Gunakan properti untuk menentukan bagaimana kontrol diubah ukurannya secara otomatis karena kontrol induknya diubah ukurannya. Misalnya, pengaturan Dock untuk DockStyle.Left menyebabkan kontrol menyelaraskan dirinya dengan tepi kiri kontrol induknya dan mengubah ukuran saat kontrol induk diubah ukurannya. Kontrol ditambatkan dalam urutan Z mereka, yang merupakan lapisan visual kontrol pada formulir di sepanjang sumbu Z formulir (kedalaman).

Kontrol dapat ditampung ke satu tepi kontainer induknya atau dapat ditampar ke semua tepi dan mengisi kontainer induk.

Margin Mengatur properti pada kontrol yang ditampung tidak berpengaruh pada jarak kontrol dari tepi kontainernya.

Nota

Properti Anchor dan Dock saling eksklusif. Hanya satu yang dapat diatur pada satu waktu, dan satu set terakhir lebih diutamakan.

Catatan Bagi Inheritor

Saat mengambil alih Dock properti di kelas turunan, gunakan properti kelas Dock dasar untuk memperluas implementasi dasar. Jika tidak, Anda harus menyediakan semua implementasi. Anda tidak diharuskan untuk mengambil get alih metode Dock dan set properti; Anda hanya dapat mengambil alih satu jika diperlukan.

Lihat juga

• DockStyle
• Anchor
• ScrollableControl.DockPaddingEdges
• Layout