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.

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 l'objet DockStyle. La valeur par défaut est None.

Exceptions

La valeur assignée ne fait pas partie des valeurs DockStyle.

Exemples

L’exemple de code suivant crée un GroupBox et définit certaines de ses propriétés communes. L’exemple crée un TextBox et définit son Location dans la zone de groupe. Ensuite, il définit la Text propriété de la zone de groupe et ancre la zone de groupe en haut du formulaire. Enfin, il désactive la zone de groupe en affectant à falsela propriété la Enabled valeur , ce qui entraîne la désactivation de tous les contrôles contenus dans la zone de groupe.

   // 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 Dock propriété pour définir comment un contrôle est redimensionné automatiquement à mesure que son contrôle parent est redimensionné. Par exemple, si vous définissez DockDockStyle.Left sur, le contrôle s’aligne sur les bords gauches de son contrôle parent et le redimensionne à mesure que le contrôle parent est redimensionné. Les contrôles sont ancrés dans leur ordre de plan, qui est la superposition visuelle de contrôles sur un formulaire le long de l’axe Z du formulaire (profondeur).

Un contrôle peut être ancré à un bord de son conteneur parent ou peut être ancré à tous les bords et remplir le conteneur parent.

La définition de la Margin propriété sur un contrôle ancré n’a aucun effet sur la distance du contrôle par rapport aux bords de son conteneur.

Notes

Les Anchor propriétés et Dock s’excluent mutuellement. Un seul peut être défini à la fois, et le dernier est prioritaire.

Notes pour les héritiers

Lorsque vous substituez la Dock propriété dans une classe dérivée, utilisez la propriété de la classe de Dock base pour étendre l’implémentation de base. Sinon, vous devez fournir toute l’implémentation. Vous n’êtes pas obligé de remplacer à la fois les get méthodes et set de la Dock propriété ; vous ne pouvez en remplacer qu’une seule si nécessaire.

S’applique à

Voir aussi