TableLayoutControlCollection.Add(Control, Int32, Int32) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
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.