TableLayoutControlCollection.Add(Control, Int32, Int32) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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.