TableLayoutControlCollection.Add(Control, Int32, Int32) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Adiciona o controle especificado à coleção e o posiciona 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 -> unitPublic Overridable Sub Add (control As Control, column As Integer, row As Integer)Parâmetros
- control
- Control
O controle a se adicionar.
- column
- Int32
A coluna na qual control será colocado.
- row
- Int32
A linha na qual control será colocado.
Exceções
column ou row é menor que -1.
Comentários
Com Add, você pode especificar a posição da célula de control. Você pode atribuir control a uma célula específica fornecendo os parâmetros e row os column parâmetros ou pode especificar apenas o valor de coluna ou linha e deixar o LayoutEngine local control na próxima célula aberta. Isso é conhecido como deixar o controle fluir para sua posição no TableLayoutPanel controle.
Defina column como -1 se você quiser control ocupar uma posição de linha fixa.
Defina row como -1 se você quiser control ocupar uma posição de coluna fixa.
Se nem column for row -1, control será adicionado na posição absoluta fornecida por (column, row).
Se você definir tanto como column row -1, control fluirá para a primeira posição aberta, com o comportamento de fluxo específico definido pelo TableLayoutPanel.GrowStyle valor. Isso é equivalente ao uso do Control.ControlCollection.Add método.
Para chegar à posição atual real de um controle, use o TableLayoutPanel.GetPositionFromControl método. Esse método leva em conta todo TableLayoutPanel o estado de controle, incluindo a abrangência de colunas ou linhas e quando ele TableLayoutPanel.LayoutEngine colocou um controle com suas Column propriedades definidas Row como -1.