Control.Dock Propriété

Définition

Obtient ou définit les bordures de contrôle qui sont ancrées à son contrôle parent et détermine le redimensionnement d'un contrôle avec son parent.Gets or sets which control borders are docked to its parent control and determines how a control is resized with its parent.

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

Valeur de propriété

Une des valeurs de DockStyle.One of the DockStyle values. La valeur par défaut est None.The default is None.

Exceptions

La valeur assignée ne fait pas partie des valeurs DockStyle.The value assigned is not one of the DockStyle values.

Exemples

L’exemple de code suivant crée un GroupBox et définit certaines de ses propriétés communes.The following code example creates a GroupBox and sets some of its common properties. L’exemple crée un TextBox et définit son Location dans la zone de groupe.The example creates a TextBox and sets its Location within the group box. Ensuite, il définit la propriété Text de la zone de groupe et ancre la zone de groupe en haut du formulaire.Next, it sets the Text property of the group box, and docks the group box to the top of the form. Enfin, elle désactive la zone de groupe en affectant à la propriété Enabled la valeur false, ce qui entraîne la désactivation de tous les contrôles contenus dans la zone de groupe.Lastly, it disables the group box by setting the Enabled property to false, which causes all controls contained within the group box to be disabled.

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

Remarques

Utilisez la propriété Dock pour définir la manière dont un contrôle est redimensionné automatiquement en fonction du redimensionnement de son contrôle parent.Use the Dock property to define how a control is automatically resized as its parent control is resized. Par exemple, la définition de Dock à DockStyle.Left provoque l’alignement du contrôle avec les bords gauche de son contrôle parent et le redimensionnement lorsque le contrôle parent est redimensionné.For example, setting Dock to DockStyle.Left causes the control to align itself with the left edges of its parent control and to resize as the parent control is resized. Les contrôles sont ancrés dans leur ordre de plan, qui est la superposition visuelle des contrôles sur un formulaire le long de l’axe Z du formulaire (profondeur).Controls are docked in their Z-order, which is the visual layering of controls on a form along the form's Z-axis (depth).

Un contrôle peut être ancré à un bord de son conteneur parent ou peut être ancré à tous les bords et remplir le conteneur parent.A control can be docked to one edge of its parent container or can be docked to all edges and fill the parent container.

La définition de la propriété Margin sur un contrôle ancré n’a aucun effet sur la distance du contrôle à partir des bords de son conteneur.Setting the Margin property on a docked control has no effect on the distance of the control from the edges of its container.

Notes

Les propriétés Anchor et Dock s’excluent mutuellement.The Anchor and Dock properties are mutually exclusive. Une seule peut être définie à la fois et la dernière définie est prioritaire.Only one can be set at a time, and the last one set takes precedence.

Notes pour les héritiers

Lors de la substitution de la propriété Dock dans une classe dérivée, utilisez la propriété Dock de la classe de base pour étendre l’implémentation de base.When overriding the Dock property in a derived class, use the base class's Dock property to extend the base implementation. Sinon, vous devez fournir toute l’implémentation.Otherwise, you must provide all the implementation. Vous n’êtes pas tenu de substituer les méthodes get et set de la propriété Dock ; vous ne pouvez substituer qu’un seul si nécessaire.You are not required to override both the get and set methods of the Dock property; you can override only one if needed.

S’applique à

Voir aussi