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.