Form.ControlCollection.Add メソッド

.NET Framework クラス ライブラリ リファレンス

Form.ControlCollection.Add メソッド

コントロールをフォームに追加します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Overrides Sub Add
 ( _
    value As Control _
)

Visual Basic (使用法)

Dim instance As ControlCollection
Dim value As Control

instance.Add(value)

C#

public override void Add (
    Control value
)

C++

public:
virtual void Add (
    Control^ value
) override

J#

public void Add (
    Control value
)

JScript

public override function Add (
    value : Control
)

パラメータ

value

フォームに追加する Control。

例外

例外の種類	条件
Exception	マルチ ドキュメント インターフェイス (MDI: Multiple Document Interface) 親フォームには、コントロールを追加できません。

解説

このメソッドを使用して、コントロールをフォームに追加できます。既に作成されているコントロールのグループをフォームに追加する場合は、Control.ControlCollection クラスの Control.ControlCollection.AddRange メソッドを使用します。

使用例

TextBox コントロールと Label コントロールをフォームのコントロール コレクションに追加するコード例を次に示します。この例では、フォームが Form1 という名前で作成されている必要があります。

Visual Basic

Public Sub AddMyControls()
    Dim textBox1 As New
 TextBox()
    Dim label1 As New Label()
    
    ' Initialize the controls and their bounds.
    label1.Text = "First Name"
    label1.Location = New Point(48, 48)
    label1.Size = New Size(104, 16)
    textBox1.Text = ""
    textBox1.Location = New Point(48, 64)
    textBox1.Size = New Size(104, 16)
    
    ' Add the TextBox control to the form's control collection.
    Controls.Add(textBox1)
    ' Add the Label control to the form's control collection.
    Controls.Add(label1)
End Sub 'AddMyControls

C#

public void AddMyControls()
 {
    TextBox textBox1 = new TextBox();
    Label label1 = new Label();
    
    // Initialize the controls and their bounds.
    label1.Text = "First Name";
    label1.Location = new Point(48,48);
    label1.Size = new Size (104, 16);
    textBox1.Text = "";
    textBox1.Location = new Point(48, 64);
    textBox1.Size = new Size(104,16);
 
    // Add the TextBox control to the form's control collection.
    Controls.Add(textBox1);
    // Add the Label control to the form's control collection.
    Controls.Add(label1);
 }
 

C++

public:
   void AddMyControls()
   {
      TextBox^ textBox1 = gcnew TextBox;
      Label^ label1 = gcnew Label;
      
      // Initialize the controls and their bounds.
      label1->Text = "First Name";
      label1->Location = Point( 48, 48 );
      label1->Size = System::Drawing::Size( 104, 16 );
      textBox1->Text = "";
      textBox1->Location = Point(48,64);
      textBox1->Size = System::Drawing::Size( 104, 16 );
      
      // Add the TextBox control to the form's control collection.
      Controls->Add( textBox1 );
      // Add the Label control to the form's control collection.
      Controls->Add( label1 );
   }

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
Form.ControlCollection クラス
Form.ControlCollection メンバ
System.Windows.Forms 名前空間
Remove