Cette page vous a-t-elle été utile ?
Votre avis sur ce contenu est important. N'hésitez pas à nous faire part de vos commentaires.
Vous avez d'autres commentaires ?
1500 caractères restants
Exporter (0) Imprimer
Développer tout
Développer Réduire
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

Control.Dock, propriété

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.

Espace de noms :  System.Windows.Forms
Assembly :  System.Windows.Forms (dans System.Windows.Forms.dll)

public virtual DockStyle Dock { get; set; }

Valeur de propriété

Type : System.Windows.Forms.DockStyle
Une des valeurs de DockStyle. La valeur par défaut est None.

ExceptionCondition
InvalidEnumArgumentException

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

Utilisez la propriété Dock pour définir comment un contrôle est redimensionné automatiquement pour atteindre la même taille que son contrôle parent. Par exemple, si Dock est affecté à DockStyle.Left, alors le contrôle s'aligne aux bords gauches de son contrôle parent et est redimensionné pour atteindre la taille du contrôle parent. Les contrôles sont ancrés dans leur ordre de plan, qui est la superposition visuelle des contrôles d'un formulaire sur l'axe Z du formulaire (profondeur).

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

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

RemarqueRemarque

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

Remarques à l'attention des 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. Sinon, vous devez fournir toute l'implémentation. Il n'est pas nécessaire de substituer les deux méthodes get et set de la propriété Dock ; vous pouvez en substituer une seule si nécessaire.

L'exemple de code suivant crée un objet 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 propriété Text de la zone de groupe et ancre cette dernière en haut du formulaire. Enfin, il désactive la zone de groupe en affectant à la propriété Enabled la valeur false 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 = 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);
}


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft