Control.ControlCollection クラス

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

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

public: ref class Control::ControlCollection : System::Windows::Forms::Layout::ArrangedElementCollection, ICloneable, System::Collections::IList

[System.ComponentModel.ListBindable(false)]
public class Control.ControlCollection : System.Windows.Forms.Layout.ArrangedElementCollection, ICloneable, System.Collections.IList

[<System.ComponentModel.ListBindable(false)>]
type Control.ControlCollection = class
    inherit ArrangedElementCollection
    interface IList
    interface ICollection
    interface IEnumerable
    interface ICloneable

Public Class Control.ControlCollection
Inherits ArrangedElementCollection
Implements ICloneable, IList

継承

Object

ArrangedElementCollection

Control.ControlCollection

派生

System.Windows.Forms.DataGridView.DataGridViewControlCollection

System.Windows.Forms.Form.ControlCollection

System.Windows.Forms.MdiClient.ControlCollection

System.Windows.Forms.TabControl.ControlCollection

System.Windows.Forms.TableLayoutControlCollection

System.Windows.Forms.TabPage.TabPageControlCollection

属性

ListBindableAttribute

実装

ICollection IEnumerable IList ICloneable

例

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

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

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

' 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(RemoveButton) Then
        Panel1.Controls.Remove(RemoveButton)
    End If
End Sub

注釈

、AddRemove、および RemoveAt の各メソッドを使用すると、コレクションに対して個々のコントロールを追加および削除できます。 または Clear メソッドをAddRange使用して、コレクションのすべてのコントロールを追加または削除することもできます。

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

コンストラクター

Control.ControlCollection(Control)

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

プロパティ

Count	コレクション内の要素の数を取得します。 (継承元 ArrangedElementCollection)
IsReadOnly	コレクションが読み取り専用かどうかを示す値を取得します。 (継承元 ArrangedElementCollection)
Item[Int32]	コレクション内の指定したインデックス位置にある Control を示します。
Item[String]	コレクション内の指定したキーを持つ Control を示します。
Owner	この Control.ControlCollection を所有しているコントロールを取得します。

メソッド

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

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

ICloneable.Clone()	この API は製品インフラストラクチャをサポートします。コードから直接使用するものではありません。 このメンバーの詳細については、「Clone()」をご覧ください。
ICollection.IsSynchronized	このメンバーの説明については、IsSynchronized プロパティを参照してください。 (継承元 ArrangedElementCollection)
ICollection.SyncRoot	このメンバーの説明については、SyncRoot プロパティを参照してください。 (継承元 ArrangedElementCollection)
IList.Add(Object)	この API は製品インフラストラクチャをサポートします。コードから直接使用するものではありません。 このメンバーの詳細については、「Add(Object)」をご覧ください。
IList.Clear()	このメンバーの説明については、Clear() メソッドのトピックを参照してください。 (継承元 ArrangedElementCollection)
IList.Contains(Object)	このメンバーの説明については、Contains(Object) メソッドのトピックを参照してください。 (継承元 ArrangedElementCollection)
IList.IndexOf(Object)	このメンバーの説明については、IndexOf(Object) メソッドのトピックを参照してください。 (継承元 ArrangedElementCollection)
IList.Insert(Int32, Object)	このメンバーの説明については、Insert(Int32, Object) メソッドのトピックを参照してください。 (継承元 ArrangedElementCollection)
IList.IsFixedSize	このメンバーの説明については、IsFixedSize プロパティを参照してください。 (継承元 ArrangedElementCollection)
IList.Item[Int32]	このメンバーの説明については、Item[Int32] プロパティを参照してください。 (継承元 ArrangedElementCollection)
IList.Remove(Object)	この API は製品インフラストラクチャをサポートします。コードから直接使用するものではありません。 このメンバーの詳細については、「Remove(Object)」をご覧ください。
IList.RemoveAt(Int32)	このメンバーの説明については、RemoveAt(Int32) メソッドのトピックを参照してください。 (継承元 ArrangedElementCollection)

拡張メソッド

こちらもご覧ください

• Control
• IList