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

Definição

Adiciona o controlo especificado à coleção e posiciona-o na célula 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

O controlo a acrescentar.

column
Int32

A coluna onde control será colocada.

row
Int32

A fila onde control será colocada.

Exceções

Ou columnrow ou é inferior a -1.

Observações

Com Add, pode especificar a posição da célula de control. Pode atribuir control a uma célula específica fornecendo ambos os column parâmetros e, row ou pode especificar apenas o valor da coluna ou linha e deixar o LayoutEngine lugar control na próxima célula aberta. Isto é conhecido como deixar o controlo fluir para a sua posição dentro do TableLayoutPanel controlo.

Define column para -1 se quiseres control ocupar uma posição fixa na fila.

Define row para -1 se quiseres control ocupar uma posição fixa numa coluna.

Se nem column nem row for -1, control será somado na posição absoluta dada por (column, row).

Se definir ambos column e row para -1, control fluirá para a primeira posição aberta, com o comportamento específico do fluxo definido pelo TableLayoutPanel.GrowStyle valor. Isto é equivalente a usar o Control.ControlCollection.Add método.

Para chegar à posição atual real de um controlo, use o TableLayoutPanel.GetPositionFromControl método. Este método tem em conta todo TableLayoutPanel o estado de controlo, incluindo a extensão de colunas ou linhas e quando o TableLayoutPanel.LayoutEngine colocou um controlo com as propriedades e ColumnRow definidas em -1.

Aplica-se a

Ver também