Control.Dock Egenskap

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

Egenskapsvärde

Ett av DockStyle värdena. Standardvärdet är None.

Undantag

Exempel

Följande kodexempel skapar en GroupBox och anger några av dess gemensamma egenskaper. Exemplet skapar en TextBox och anger dess Location i grupprutan. Därefter anger den Text egenskapen för grupprutan och dockar grupprutan överst i formuläret. Slutligen inaktiveras grupprutan genom att egenskapen anges Enabled till false, vilket gör att alla kontroller i grupprutan inaktiveras.

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

Kommentarer

Använd egenskapen Dock för att definiera hur en kontroll automatiskt ändras när dess överordnade kontroll ändras. Om du till exempel anger Dock att DockStyle.Left kontrollen ska justeras mot den överordnade kontrollens vänsterkanter och ändra storlek när den överordnade kontrollen ändras. Kontrollerna dockas i sin Z-ordning, vilket är den visuella skiktningen av kontroller i ett formulär längs formulärets Z-axel (djup).

En kontroll kan dockas till en kant av den överordnade containern eller dockas till alla kanter och fylla den överordnade containern.

Om du ställer in egenskapen Margin på en dockad kontroll påverkas inte kontrollens avstånd från containerns kanter.

Anteckningar till arvingar

När du åsidosättar Dock egenskapen i en härledd klass använder du basklassens Dock egenskap för att utöka basimplementeringen. Annars måste du ange all implementering. Du behöver inte åsidosätta både get - och set -metoderna för Dock egenskapen. Du kan bara åsidosätta en om det behövs.

Se även

• DockStyle
• Anchor
• ScrollableControl.DockPaddingEdges
• Layout