Partager via


TableLayoutControlCollection.Add(Control, Int32, Int32) Méthode

Définition

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 -> unit
Public 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.

S’applique à

Voir aussi