Control.Dock Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit les bordures de contrôle ancrées à son contrôle parent et détermine comment un contrôle est redimensionné 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, setPublic Overridable Property Dock As DockStyleValeur de propriété
Une des DockStyle valeurs. La valeur par défaut est None.
Exceptions
La valeur affectée n’est pas l’une DockStyle des valeurs.
Exemples
L’exemple de code suivant crée une GroupBox et définit certaines de ses propriétés communes. L’exemple crée une TextBox zone de groupe et la définit Location . 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 définissant la Enabled propriété falsesur , 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 automatiquement redimensionné à mesure que son contrôle parent est redimensionné. Par exemple, le paramètre Dock pour DockStyle.Left provoquer l’alignement du contrôle sur les bords gauches de son contrôle parent et le redimensionnement à mesure que le contrôle parent est redimensionné. Les contrôles sont ancrés dans leur ordre Z, qui est la couche visuelle des 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 être ancré sur 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 à partir des bords de son conteneur.
Note
Les Anchor propriétés et Dock les propriétés s’excluent mutuellement. Un seul peut être défini à la fois, et le dernier ensemble est prioritaire.
Notes pour les héritiers
En cas de substitution de 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 toutes les implémentations. Vous n’êtes pas obligé de remplacer à la fois les méthodes et set les get méthodes de la Dock propriété ; vous ne pouvez remplacer qu’une seule si nécessaire.
