Form.ControlCollection

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

Form.ControlCollection クラス

フォーム上のコントロールのコレクションを表します。

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

Visual Basic (宣言)

<ComVisibleAttribute(False)> _
Public Class ControlCollection
    Inherits ControlCollection

Visual Basic (使用法)

Dim instance As ControlCollection

C#

[ComVisibleAttribute(false)] 
public class ControlCollection : ControlCollection

C++

[ComVisibleAttribute(false)] 
public ref class ControlCollection : public
 ControlCollection

J#

/** @attribute ComVisibleAttribute(false) */ 
public class ControlCollection extends ControlCollection

JScript

ComVisibleAttribute(false) 
public class ControlCollection extends
 ControlCollection

解説

このクラスは、フォームに配置されているコントロールのコレクションを表します。フォームにコントロールを追加するには Add メソッドを使用し、フォームからコントロールを削除するには Remove メソッドを使用します。このクラスによって表されるコントロール コレクションを作成するには、そのコレクションを特定のフォームに関連付ける必要があります。このため、このコントロール コレクションの複数のインスタンスを作成し、アクティブなフォームをこれらのインスタンスで置き換えることによってコントロールを異なるレイアウトで配置することはできません。

使用例

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 );
   }

継承階層

System.Object
   System.Windows.Forms.Layout.ArrangedElementCollection
     System.Windows.Forms.Control.ControlCollection
      System.Windows.Forms.Form.ControlCollection

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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 メンバ
System.Windows.Forms 名前空間
Control.ControlCollection クラス

Form.ControlCollection コンストラクタ

Form.ControlCollection クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    owner As Form _
)

Visual Basic (使用法)

Dim owner As Form

Dim instance As New ControlCollection(owner)

C#

public ControlCollection (
    Form owner
)

C++

public:
ControlCollection (
    Form^ owner
)

J#

public ControlCollection (
    Form owner
)

JScript

public function ControlCollection (
    owner : Form
)

パラメータ

owner

コントロール コレクションに追加されるコントロールを保持する Form。

解説

このコンストラクタを使用すると、コントロール コレクションをフォームに適切に関連付け、コントロールをフォームに追加できるようになります。

メモ
コントロール コレクションは関連付けるフォームを指定して作成する必要があるため、コントロールの複数のコレクションを作成し、それらのコレクションでフォームを置き換えることはできません。

プラットフォーム

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 名前空間

Form.ControlCollection プロパティ

パブリック プロパティ

	名前	説明
	Count	コレクション内の要素の数を取得します。 ( ArrangedElementCollection から継承されます。)
	IsReadOnly	コレクションが読み取り専用かどうかを示す値を取得します。 ( ArrangedElementCollection から継承されます。)
	Item	オーバーロードされます。 コレクション内の Control を示します。 ( Control.ControlCollection から継承されます。)
	Owner	この Control.ControlCollection を所有しているコントロールを取得します。 ( Control.ControlCollection から継承されます。)

参照

関連項目

Form.ControlCollection クラス
System.Windows.Forms 名前空間
Control.ControlCollection クラス

Form.ControlCollection メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Add	オーバーライドされます。 コントロールをフォームに追加します。
	AddRange	コレクションにコントロール オブジェクトの配列を追加します。 ( Control.ControlCollection から継承されます。)
	Clear	コレクションからすべてのコントロールを削除します。 ( Control.ControlCollection から継承されます。)
	Contains	指定したコントロールがコレクションのメンバかどうかを確認します。 ( Control.ControlCollection から継承されます。)
	ContainsKey	指定したキーを持つ項目が Control.ControlCollection に含まれているかどうかを確認します。 ( Control.ControlCollection から継承されます。)
	CopyTo	コピー先配列の指定されたインデックスを開始位置として、このコレクションの内容全体を互換性がある 1 次元 Array にコピーします。 ( ArrangedElementCollection から継承されます。)
	Equals	オーバーロードされます。 2 つの ArrangedElementCollection インスタンスが等しいかどうかを判断します。 ( ArrangedElementCollection から継承されます。)
	Find	コントロールの Name プロパティに基づいてコントロールを検索し、一致するすべてのコントロールの配列を構築します。 ( Control.ControlCollection から継承されます。)
	GetChildIndex	オーバーロードされます。 コントロール コレクション内のコントロールのインデックスを取得します。 ( Control.ControlCollection から継承されます。)
	GetEnumerator	Control.ControlCollection の反復処理に使用する列挙体オブジェクトへの参照を取得します。 ( Control.ControlCollection から継承されます。)
	GetHashCode	このインスタンスのハッシュ コードを返します。 ( ArrangedElementCollection から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	IndexOf	コントロール コレクション内の指定したコントロールのインデックスを取得します。 ( Control.ControlCollection から継承されます。)
	IndexOfKey	指定した項目がこのコレクション内で最初に見つかった位置のインデックスを取得します。 ( Control.ControlCollection から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	Remove	オーバーライドされます。 フォームからコントロールを削除します。
	RemoveAt	指定したインデックス位置にあるコントロール コレクションからコントロールを削除します。 ( Control.ControlCollection から継承されます。)
	RemoveByKey	指定したキーを持つ子コントロールを削除します。 ( Control.ControlCollection から継承されます。)
	SetChildIndex	コレクション内の指定した子コントロールのインデックスを指定したインデックス値に設定します。 ( Control.ControlCollection から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

Form.ControlCollection クラス
System.Windows.Forms 名前空間
Control.ControlCollection クラス

Form.ControlCollection メンバ

フォーム上のコントロールのコレクションを表します。

Form.ControlCollection データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	Form.ControlCollection	Form.ControlCollection クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	Count	コレクション内の要素の数を取得します。(ArrangedElementCollection から継承されます。)
	IsReadOnly	コレクションが読み取り専用かどうかを示す値を取得します。(ArrangedElementCollection から継承されます。)
	Item	オーバーロードされます。 コレクション内の Control を示します。(Control.ControlCollection から継承されます。)
	Owner	この Control.ControlCollection を所有しているコントロールを取得します。(Control.ControlCollection から継承されます。)

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Add	オーバーライドされます。 コントロールをフォームに追加します。
	AddRange	コレクションにコントロール オブジェクトの配列を追加します。 (Control.ControlCollection から継承されます。)
	Clear	コレクションからすべてのコントロールを削除します。 (Control.ControlCollection から継承されます。)
	Contains	指定したコントロールがコレクションのメンバかどうかを確認します。 (Control.ControlCollection から継承されます。)
	ContainsKey	指定したキーを持つ項目が Control.ControlCollection に含まれているかどうかを確認します。 (Control.ControlCollection から継承されます。)
	CopyTo	コピー先配列の指定されたインデックスを開始位置として、このコレクションの内容全体を互換性がある 1 次元 Array にコピーします。 (ArrangedElementCollection から継承されます。)
	Equals	オーバーロードされます。 2 つの ArrangedElementCollection インスタンスが等しいかどうかを判断します。 (ArrangedElementCollection から継承されます。)
	Find	コントロールの Name プロパティに基づいてコントロールを検索し、一致するすべてのコントロールの配列を構築します。 (Control.ControlCollection から継承されます。)
	GetChildIndex	オーバーロードされます。 コントロール コレクション内のコントロールのインデックスを取得します。 (Control.ControlCollection から継承されます。)
	GetEnumerator	Control.ControlCollection の反復処理に使用する列挙体オブジェクトへの参照を取得します。 (Control.ControlCollection から継承されます。)
	GetHashCode	このインスタンスのハッシュ コードを返します。 (ArrangedElementCollection から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	IndexOf	コントロール コレクション内の指定したコントロールのインデックスを取得します。 (Control.ControlCollection から継承されます。)
	IndexOfKey	指定した項目がこのコレクション内で最初に見つかった位置のインデックスを取得します。 (Control.ControlCollection から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	Remove	オーバーライドされます。 フォームからコントロールを削除します。
	RemoveAt	指定したインデックス位置にあるコントロール コレクションからコントロールを削除します。 (Control.ControlCollection から継承されます。)
	RemoveByKey	指定したキーを持つ子コントロールを削除します。 (Control.ControlCollection から継承されます。)
	SetChildIndex	コレクション内の指定した子コントロールのインデックスを指定したインデックス値に設定します。 (Control.ControlCollection から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

Form.ControlCollection クラス
System.Windows.Forms 名前空間
Control.ControlCollection クラス