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