TableLayoutControlCollection.Add(Control, Int32, Int32) メソッド

定義

名前空間:
System.Windows.Forms
アセンブリ:
System.Windows.Forms.dll
ソース:
TableLayoutControlCollection.cs
ソース:
TableLayoutControlCollection.cs
ソース:
TableLayoutControlCollection.cs
ソース:
TableLayoutControlCollection.cs
ソース:
TableLayoutControlCollection.cs

指定したコントロールをコレクションに追加し、指定したセルに配置します。

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)

パラメーター

control
Control

追加するコントロール。

column
Int32

controlが配置される列。

row
Int32

controlが配置される行。

例外

ArgumentException

columnまたはrowのいずれかが -1 未満です。

注釈

Addでは、controlのセル位置を指定できます。 controlパラメーターとcolumn パラメーターの両方を指定して特定のセルにrowを割り当てたり、列または行の値のみを指定したり、LayoutEngineで次の開いているセルにcontrolを配置したりできます。 これは、制御がコントロール内の位置にTableLayoutPanelと呼ばれます。

固定行位置を占有column場合は、controlを -1 に設定します。

固定列の位置を占有row場合は、controlを -1 に設定します。

columnもrowも -1 でない場合、(control、column) によって指定された絶対位置にrowが追加されます。

columnとrowの両方を -1 に設定すると、controlは最初のオープン位置にフローし、TableLayoutPanel.GrowStyle値によって特定のフロー動作が定義されます。 これは、 Control.ControlCollection.Add メソッドの使用と同じです。

コントロールの実際の現在位置に到達するには、 TableLayoutPanel.GetPositionFromControl メソッドを使用します。 このメソッドは、 TableLayoutPanel コントロールの状態全体 (列または行にまたがるものも含む) を考慮し、 TableLayoutPanel.LayoutEngine がその Column プロパティと Row プロパティを -1 に設定してコントロールを配置した場合を考慮します。

適用対象

こちらもご覧ください