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.