TableLayoutControlCollection.Add(Control, Int32, Int32) Metoda

  • Reference

Definice

Obor názvů:
System.Windows.Forms
Sestavení:
System.Windows.Forms.dll

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

ArgumentException

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

Poznámky

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

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

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

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

Pokud nastavíte hodnotu column -1, row control přejde 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.

Pokud se chcete dostat na skutečnou aktuální pozici ovládacího prvku, použijte metodu TableLayoutPanel.GetPositionFromControl . Tato metoda bere v úvahu celý TableLayoutPanel stav ovládacího prvku, včetně rozsahu sloupců nebo řádků a při TableLayoutPanel.LayoutEngine umístění ovládacího prvku s jeho Column a Row vlastnostmi nastavenými na -1.

Platí pro

Viz také