TableLayoutControlCollection.Add(Control, Int32, Int32) Methode

Definition

Fügt das angegebene Steuerelement der Auflistung hinzu und positioniert es an der angegebenen Zelle.

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)

Parameter

control
Control

Das hinzuzufügende Steuerelement.

column
Int32

Die Spalte, in der control sie platziert wird.

row
Int32

Die Zeile, in der control sie platziert wird.

Ausnahmen

Entweder column oder row ist kleiner als -1.

Hinweise

Mit Add, können Sie die Zellenposition von control. Sie können einer bestimmten Zelle zuweisencontrol, indem Sie sowohl die column Parameter angebenrow, als auch nur den Spalten- oder Zeilenwert angeben und die Stelle LayoutEngine an der control nächsten geöffneten Zelle zulassen. Dies wird so bezeichnet, dass der Steuerfluss an seine Position im TableLayoutPanel Steuerelement übergeben wird.

Legen Sie column diesen Satz auf -1 fest, wenn Sie eine feste Zeilenposition einnehmen möchten control .

Legen Sie row diese Einstellung auf -1 fest, wenn Sie eine feste Spaltenposition einnehmen möchten control .

Wenn weder columnrow -1 noch -1 ist, control wird an der absoluten Position hinzugefügt, die durch (column, row) angegeben wird.

Wenn Sie sowohl als auch columnrow auf -1 festlegen, control wird die erste offene Position mit dem vom TableLayoutPanel.GrowStyle Wert definierten spezifischen Flussverhalten fließen. Dies entspricht der Verwendung der Control.ControlCollection.Add Methode.

Verwenden Sie die TableLayoutPanel.GetPositionFromControl Methode, um zur aktuellen Position eines Steuerelements zu gelangen. Diese Methode berücksichtigt den gesamten TableLayoutPanel Steuerelementzustand, einschließlich Spalten- oder Zeilenspannen, und wenn das TableLayoutPanel.LayoutEngine Steuerelement mit seinen Column auf Row -1 festgelegten Eigenschaften platziert wurde.

Gilt für:

Weitere Informationen