TableLayoutControlCollection.Add(Control, Int32, Int32) Metoda

Definice

Přidá zadaný ovládací prvek do kolekce a umístí ho do zadané buňky.

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

Ovládací prvek, který chcete přidat.

column
Int32

Sloupec, do kterého control se umístí.

row
Int32

Řádek, do kterého control se umístí.

Výjimky

Buď column nebo row je menší než -1.

Poznámky

Pomocí Add, můžete zadat umístění controlbuňky . Ke konkrétní buňce můžete přiřadit control zadáním parametrů i column parametrů, nebo můžete zadat pouze hodnotu sloupce nebo řádku a nechat row místo LayoutEngine na další otevřené control buňce. To se označuje jako tok řízení do jeho pozice v ovládacím TableLayoutPanel prvku.

Pokud chcete column zabírat pevnou pozici řádku, nastavte control -1.

Pokud chcete row zabírat pevnou pozici sloupce, nastavte control -1.

Pokud není column ani row -1, control přidá se na absolutní pozici danou (column, row).

Pokud nastavíte hodnotu columnrow a hodnotu -1, control bude tok na první otevřenou pozici s konkrétním chováním toku definovaným TableLayoutPanel.GrowStyle hodnotou. To je ekvivalentní použití Control.ControlCollection.Add metody.

K získání skutečné aktuální pozice ovládacího prvku použijte metodu TableLayoutPanel.GetPositionFromControl . Tato metoda bere v úvahu celý TableLayoutPanel stav ovládacího prvku, včetně rozsazení sloupců nebo řádků a kdy TableLayoutPanel.LayoutEngine má ovládací prvek s jeho Column a Row vlastnostmi nastavenými na -1.

Platí pro

Viz také