TableLayoutControlCollection.Add(Control, Int32, Int32) Methode

Definition

Fügt der Auflistung das angegebene Steuerelement hinzu und positioniert es in 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 platziert wird.

row
Int32

Die Zeile, in der control platziert wird.

Ausnahmen

Entwedercolumn oder row ist kleiner als -1.

Hinweise

Mit Addkönnen Sie die Zellenposition von controlangeben. Sie können eine bestimmte Zelle zuweisencontrol, indem Sie sowohl die column Parameter als row auch angeben, oder Sie können nur den Spalten- oder Zeilenwert angeben und die Position control an der LayoutEngine nächsten geöffneten Zelle zulassen. Dies wird so bezeichnet, dass die Steuerung an ihre Position im TableLayoutPanel Steuerelement fließt.

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

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

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

Wenn Sie sowohl als auch columnrow auf -1 festlegen, control wird zur ersten geöffneten Position mit dem durch den TableLayoutPanel.GrowStyle Wert definierten spezifischen Flussverhalten geleitet. Dies entspricht der Verwendung der Control.ControlCollection.Add -Methode.

Verwenden Sie die -Methode, um zur aktuellen Position eines Steuerelements TableLayoutPanel.GetPositionFromControl zu gelangen. Diese Methode berücksichtigt den gesamten TableLayoutPanel Steuerelementstatus, einschließlich spalten- oder zeilenübergreifend, und wenn ein TableLayoutPanel.LayoutEngine Steuerelement mit seinen Column Eigenschaften und Row auf -1 festgelegt wurde.

Gilt für:

Weitere Informationen