TableLayoutControlCollection.Add(Control, Int32, Int32) Méthode
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.
Ajoute le contrôle spécifié à la collection et le place à la cellule spécifiée.
public:
virtual void Add(System::Windows::Forms::Control ^ control, int column, int row);public virtual void Add (System.Windows.Forms.Control control, int column, int row);override this.Add : System.Windows.Forms.Control * int * int -> unitPublic Overridable Sub Add (control As Control, column As Integer, row As Integer)Paramètres
- control
- Control
Contrôle à ajouter.
- column
- Int32
Colonne dans laquelle control sera placé.
- row
- Int32
Ligne dans laquelle control sera placé.
Exceptions
column ou row est inférieur à -1.
Remarques
Avec Add, vous pouvez spécifier la position de la cellule de control. Vous pouvez affecter control à une cellule spécifique en fournissant à la fois les column paramètres et row , ou vous pouvez spécifier uniquement la valeur de colonne ou de ligne et laisser l’emplacement LayoutEnginecontrol à la cellule ouverte suivante. C’est ce que l’on appelle laisser le contrôle passer à sa position dans le TableLayoutPanel contrôle.
Définissez column -1 si vous souhaitez control occuper une position de ligne fixe.
Définissez row sur -1 si vous souhaitez control occuper une position de colonne fixe.
Si ni n’est columnrow -1, control est ajouté à la position absolue donnée par (column, row).
Si vous définissez à la fois column et row sur -1, control passe à la première position ouverte, avec le comportement de flux spécifique défini par la TableLayoutPanel.GrowStyle valeur. Cela équivaut à utiliser la Control.ControlCollection.Add méthode .
Pour atteindre la position actuelle réelle d’un contrôle, utilisez la TableLayoutPanel.GetPositionFromControl méthode . Cette méthode prend en compte l’état du contrôle entier TableLayoutPanel , y compris l’étendue de colonne ou de ligne et lorsque le TableLayoutPanel.LayoutEngine a placé un contrôle avec ses Column propriétés et Row définies sur -1.
