TableLayoutControlCollection.Add(Control, Int32, Int32) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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.