Control.Dock Własność

Definicja

Namespace:

System.Windows.Forms

Montaż:

System.Windows.Forms.dll

Źródło:

Control.cs

Pobiera lub ustawia, które obramowania kontrolek są zadokowane do kontrolki nadrzędnej i określa, jak zmienia się rozmiar kontrolki z jej elementem nadrzędnym.

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

Wartość nieruchomości

DockStyle

DockStyle Jedna z wartości. Wartość domyślna to None.

Wyjątki

InvalidEnumArgumentException

Przypisana wartość nie jest jedną z DockStyle wartości.

Przykłady

Poniższy przykład kodu tworzy obiekt GroupBox i ustawia niektóre z jego typowych właściwości. W przykładzie tworzony jest obiekt TextBox i ustawia go Location w polu grupy. Następnie ustawia Text właściwość pola grupy i dokuje pole grupy do góry formularza. Na koniec wyłącza pole grupy, ustawiając Enabled właściwość na false, co powoduje wyłączenie wszystkich kontrolek zawartych w polu grupy.

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

Uwagi

Dock Użyj właściwości , aby zdefiniować sposób automatycznego zmieniania rozmiaru kontrolki w miarę zmieniania rozmiaru kontrolki nadrzędnej. Na przykład ustawienie Dock powoduje DockStyle.Left wyrównanie kontrolki do lewej krawędzi jej kontrolki nadrzędnej i zmianę rozmiaru w miarę zmiany rozmiaru kontrolki nadrzędnej. Kontrolki są zadokowane w kolejności Z, czyli wizualne warstwy kontrolek na formularzu wzdłuż osi Z formularza (głębokość).

Kontrolkę można zadokować do jednej krawędzi kontenera nadrzędnego lub zadokować do wszystkich krawędzi i wypełnić kontener nadrzędny.

Margin Ustawienie właściwości w zadokowanej kontrolce nie ma wpływu na odległość kontrolki od krawędzi kontenera.

Uwaga

Właściwości Anchor i Dock wzajemnie się wykluczają. Jednocześnie można ustawić tylko jeden zestaw, a ostatni zestaw ma pierwszeństwo.

Notatki dla spadkobierców

Podczas zastępowania Dock właściwości w klasie pochodnej użyj właściwości klasy Dock bazowej, aby rozszerzyć implementację podstawową. W przeciwnym razie należy podać całą implementację. Nie jest wymagane zastąpienie zarówno metod Dock , jak get i set właściwości . W razie potrzeby można zastąpić tylko jedną.

Zobacz także

• DockStyle
• Anchor
• ScrollableControl.DockPaddingEdges
• Layout