Control.ControlCollection

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

Control.ControlCollection クラス

Control オブジェクトのコレクションを表します。

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

Visual Basic (宣言)

<ComVisibleAttribute(False)> _
Public Class ControlCollection
    Inherits ArrangedElementCollection
    Implements IList, ICollection, IEnumerable, ICloneable

Visual Basic (使用法)

Dim instance As ControlCollection

C#

[ComVisibleAttribute(false)] 
public class ControlCollection : ArrangedElementCollection,
 IList, ICollection, IEnumerable, 
    ICloneable

C++

[ComVisibleAttribute(false)] 
public ref class ControlCollection : public
 ArrangedElementCollection, IList, ICollection, IEnumerable, 
    ICloneable

J#

/** @attribute ComVisibleAttribute(false) */ 
public class ControlCollection extends ArrangedElementCollection
 implements IList, ICollection, 
    IEnumerable, ICloneable

JScript

ComVisibleAttribute(false) 
public class ControlCollection extends
 ArrangedElementCollection implements IList, ICollection, 
    IEnumerable, ICloneable

解説

Add、Remove、RemoveAt の各メソッドを使用すると、コレクションから個別のコントロールを追加および削除できます。また、AddRange メソッドや Clear メソッドを使用して、すべてのコントロールをコレクションに追加したり、コレクションから削除したりできます。

コントロールを Contains メソッドに渡すことによって、Control がコレクションのメンバかどうかを確認できます。コレクション内の Control の位置のインデックス値を取得するには、コントロールを IndexOf メソッドに渡します。CopyTo メソッドを呼び出すことによって、コレクションを配列の中にコピーできます。

使用例

Control が派生クラス Panel の Control.ControlCollection のメンバである場合に、そのコントロールをコレクションから削除するコード例を次に示します。この例では、Form 上に Panel、Button、および少なくとも 1 つの RadioButton コントロールが作成されている必要があります。RadioButton コントロールは Panel コントロールに追加され、Panel コントロールは Form コントロールに追加されます。ボタンがクリックされると、radioButton2 という名前のオプション ボタンが Control.ControlCollection から削除されます。

Visual Basic

' Remove the RadioButton control if it exists.
Private Sub RemoveButton_Click(ByVal
 sender As System.Object, _
    ByVal e As System.EventArgs) Handles
 RemoveButton.Click
    If Panel1.Controls.Contains(RadioAddRangeButton) Then
        Panel1.Controls.Remove(RadioAddRangeButton)
    End If
End Sub

C#

// Remove the RadioButton control if it exists.
private void removeButton_Click(object sender,
 System.EventArgs e)
{
   if(panel1.Controls.Contains(removeButton))
   {
      panel1.Controls.Remove(removeButton);
   }
}

C++

   // Remove the RadioButton control if it exists.
private:
   void removeButton_Click( Object^ /*sender*/, System::EventArgs^
 /*e*/ )
   {
      if ( panel1->Controls->Contains( removeButton ) )
      {
         panel1->Controls->Remove( removeButton );
      }
   }

J#

// Remove the RadioButton control if it exists.
private void removeButton_Click(Object sender,
 System.EventArgs e)
{
    if (panel1.get_Controls().Contains(removeButton)) {
        panel1.get_Controls().Remove(removeButton);
    }
} //removeButton_Click

継承階層

System.Object
   System.Windows.Forms.Layout.ArrangedElementCollection
    System.Windows.Forms.Control.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
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

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

Control.ControlCollection コンストラクタ

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

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

Visual Basic (宣言)

Public Sub New ( _
    owner As Control _
)

Visual Basic (使用法)

Dim owner As Control

Dim instance As New ControlCollection(owner)

C#

public ControlCollection (
    Control owner
)

C++

public:
ControlCollection (
    Control^ owner
)

J#

public ControlCollection (
    Control owner
)

JScript

public function ControlCollection (
    owner : Control
)

パラメータ

owner

コントロール コレクションを所有しているコントロールを表す Control。

プラットフォーム

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
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
Control.ControlCollection クラス
Control.ControlCollection メンバ
System.Windows.Forms 名前空間
Control.Controls プロパティ

Control.ControlCollection プロパティ

パブリック プロパティ

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

明示的インターフェイスの実装

	名前	説明
	System.Collections.IList.Item

参照

関連項目

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

Control.ControlCollection メソッド

パブリック メソッド

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

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

プロテクト メソッド

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

明示的インターフェイスの実装

	名前	説明
	System.Collections.IList.Add	このメンバの説明については、IList.Add のトピックを参照してください。
	System.Collections.IList.Remove	このメンバの説明については、IList.Remove のトピックを参照してください。
	System.ICloneable.Clone	現在のインスタンスのコピーである新しいオブジェクトを作成します。

参照

関連項目

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

Control.ControlCollection メンバ

Control オブジェクトのコレクションを表します。

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

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

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

パブリック プロパティ

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

パブリック メソッド

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

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

プロテクト メソッド

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

明示的インターフェイスの実装

	名前	説明
	System.Collections.IList.Add	このメンバの説明については、IList.Add のトピックを参照してください。
	System.Collections.IList.Remove	このメンバの説明については、IList.Remove のトピックを参照してください。
	System.ICloneable.Clone	現在のインスタンスのコピーである新しいオブジェクトを作成します。
	System.Collections.IList.Item

参照

関連項目

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