Control.Dock Eigenschap

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

Waarde van eigenschap

Een van de DockStyle waarden. De standaardwaarde is None.

Uitzonderingen

Voorbeelden

In het volgende codevoorbeeld worden enkele GroupBox algemene eigenschappen gemaakt en ingesteld. In het voorbeeld wordt een TextBox en ingesteld Location in het groepsvak. Vervolgens wordt de Text eigenschap van het groepsvak ingesteld en wordt het groepsvak aan de bovenkant van het formulier gekoppeld. Ten slotte wordt het groepsvak uitgeschakeld door de Enabled eigenschap falsein te stellen op, waardoor alle besturingselementen in het groepsvak worden uitgeschakeld.

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

Opmerkingen

Gebruik de Dock eigenschap om te definiëren hoe het formaat van een besturingselement automatisch wordt gewijzigd wanneer het bovenliggende besturingselement wordt gewijzigd. Als u bijvoorbeeld Dock wilt DockStyle.Left dat het besturingselement wordt uitgelijnd met de linkerranden van het bovenliggende besturingselement en het formaat ervan wijzigt wanneer het bovenliggende besturingselement wordt gewijzigd, wordt het formaat gewijzigd. Besturingselementen worden gedokt in hun Z-volgorde. Dit is de visuele laag van besturingselementen op een formulier langs de Z-as van het formulier (diepte).

Een besturingselement kan aan één rand van de bovenliggende container worden gedokt of aan alle randen worden gedokt en de bovenliggende container vullen.

Het instellen van de Margin eigenschap op een vastgezet besturingselement heeft geen invloed op de afstand van het besturingselement vanaf de randen van de container.

Notities voor overnemers

Wanneer u de Dock eigenschap in een afgeleide klasse overschrijft, gebruikt u de eigenschap van Dock de basisklasse om de basis-implementatie uit te breiden. Anders moet u alle implementaties opgeven. U hoeft niet zowel de eigenschap get als de set methoden van de Dock eigenschap te overschrijven. U kunt er slechts één overschrijven als dat nodig is.

Zie ook

• DockStyle
• Anchor
• ScrollableControl.DockPaddingEdges
• Layout