TableLayoutControlCollection.Add(Control, Int32, Int32) Метод

Определение

Добавляет указанный элемент управления в коллекцию и размещает его в указанной ячейке.

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)

Параметры

control
Control

Добавляемый элемент управления.

column
Int32

Столбец, в котором будет размещен control.

row
Int32

Строка, в которой будет размещен control.

Исключения

Значение column или row меньше –1.

Комментарии

С помощью Addэтого параметра можно указать позицию ячейки control. Вы можете назначить control определенную ячейку, указав значения column и row параметры, либо указать только значение столбца или строки, а также разрешить LayoutEngine место control в следующей открытой ячейке. Это называется разрешением потока управления на его позицию в элементе TableLayoutPanel управления.

Задайте значение column -1, если требуется control занять фиксированную позицию строки.

Задайте значение row -1, если вы хотите control занять фиксированное положение столбца.

Если ни row значение column не равно -1, будет добавлено в абсолютное положение, control заданное (column, row).

Если задано значение column -1, row control будет выполняться переход к первой открытой позиции с определенным поведением потока, определенным значением TableLayoutPanel.GrowStyle . Это эквивалентно использованию Control.ControlCollection.Add метода.

Чтобы получить фактическое текущее положение элемента управления, используйте TableLayoutPanel.GetPositionFromControl метод. Этот метод учитывает все TableLayoutPanel состояние элемента управления, включая диапазон столбцов или строк, а также когда TableLayoutPanel.LayoutEngine элемент управления помещает элемент управления со свойством Column Row -1.

Применяется к

См. также раздел