TableLayoutControlCollection.Add(Control, Int32, Int32) Metoda

Definicja

Dodaje określoną kontrolkę do kolekcji i umieszcza ją w określonej komórce.

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)

Parametry

control
Control

Kontrolka do dodania.

column
Int32

Kolumna, w której control zostanie umieszczona.

row
Int32

Wiersz, w którym control zostanie umieszczony.

Wyjątki

Wartość column lub row jest mniejsza niż -1.

Uwagi

Za pomocą Addpolecenia można określić położenie komórki .control Można przypisać control do określonej komórki, podając parametry column i row lub można określić tylko wartość kolumny lub wiersza i pozwolić, aby miejsce LayoutEngine w control następnej otwartej komórce. Jest to znane jako umożliwienie przepływowi sterowania na jego położenie w kontrolce TableLayoutPanel .

Ustaw column wartość na -1, jeśli chcesz control zajmować stałą pozycję wiersza.

Ustaw row wartość na -1, jeśli chcesz control zajmować stałe położenie kolumny.

Jeśli ani columnrow nie ma wartości -1, control zostanie dodany w pozycji bezwzględnej podanej przez (column, row).

Jeśli ustawisz wartość i columnrow -1, control przepływnie do pierwszej otwartej pozycji z określonym zachowaniem przepływu zdefiniowanym TableLayoutPanel.GrowStyle przez wartość. Jest to równoważne użyciu Control.ControlCollection.Add metody .

Aby przejść do rzeczywistej bieżącej pozycji kontrolki, użyj TableLayoutPanel.GetPositionFromControl metody . Ta metoda uwzględnia cały TableLayoutPanel stan kontrolki, w tym zakres kolumny lub wiersza, a gdy TableLayoutPanel.LayoutEngine kontrolka została umieszczona z jej Column właściwościami i Row ustawioną na -1.

Dotyczy

Zobacz też