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 positionne sur 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ée.
- row
- Int32
Ligne dans laquelle control sera placée.
Exceptions
Ou column est inférieur à row -1.
Remarques
Avec Add, vous pouvez spécifier la position de cellule de control. Vous pouvez affecter control à une cellule spécifique en fournissant à la fois les paramètres et column les row paramètres, ou vous pouvez spécifier uniquement la valeur de colonne ou de ligne et laisser l’emplacement LayoutEnginecontrol à la cellule ouverte suivante. Il s’agit de laisser le flux de contrôle à sa position dans le TableLayoutPanel contrôle.
Définissez column la valeur -1 si vous souhaitez control occuper une position de ligne fixe.
Définissez row la valeur -1 si vous souhaitez control occuper une position de colonne fixe.
Si aucun n’est column - row 1, control sera 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 accéder à la position actuelle réelle d’un contrôle, utilisez la TableLayoutPanel.GetPositionFromControl méthode. Cette méthode prend en compte l’état de contrôle entier TableLayoutPanel , y compris la colonne ou la ligne couvrant et lorsque le TableLayoutPanel.LayoutEngine contrôle a placé un contrôle avec ses Column propriétés définies Row sur -1.