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

Definición

Agrega el control especificado a la colección y lo coloca en la celda especificada.

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)

Parámetros

control
Control

Control que se va a agregar.

column
Int32

La columna en la que se colocará el control.

row
Int32

La fila en la que se colocará el control.

Excepciones

column o row es menor que -1.

Comentarios

Con Add, puede especificar la posición de la celda de control. Puede asignar control a una celda específica proporcionando los column parámetros y row , o puede especificar solo el valor de columna o fila y dejar que el LayoutEngine lugar control en la celda abierta siguiente. Esto se conoce como permitir que el flujo de control se coloque en su posición en el TableLayoutPanel control.

Establezca column en -1 si desea control ocupar una posición fija de fila.

Establezca row en -1 si desea control ocupar una posición fija de columna.

Si ni es column row -1, control se agregará en la posición absoluta dada por (column, row).

Si establece y column row en -1, control fluirá a la primera posición abierta, con el comportamiento de flujo específico definido por el TableLayoutPanel.GrowStyle valor . Esto equivale a usar el Control.ControlCollection.Add método .

Para llegar a la posición actual real de un control, use el TableLayoutPanel.GetPositionFromControl método . Este método tiene en cuenta todo TableLayoutPanel el estado de control, incluida la expansión de columnas o filas y cuando ha TableLayoutPanel.LayoutEngine colocado un control con sus Column propiedades y Row establecidas en -1.

Se aplica a

Consulte también