Control.ControlCollection.RemoveAt メソッド

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

Control.ControlCollection.RemoveAt メソッド

指定したインデックス位置にあるコントロール コレクションからコントロールを削除します。

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

Visual Basic (宣言)

Public Sub RemoveAt ( _
    index As Integer _
)

Visual Basic (使用法)

Dim instance As ControlCollection
Dim index As Integer

instance.RemoveAt(index)

C#

public void RemoveAt (
    int index
)

C++

public:
virtual void RemoveAt (
    int index
) sealed

J#

public final void RemoveAt (
    int index
)

JScript

public final function RemoveAt (
    index : int
)

パラメータ

index

削除する Control のインデックス値。

解説

コントロール コレクションから Control を削除すると、後続のすべてのコントロールが、それぞれコレクション内で 1 つ前の位置に移動します。

追加した Control を削除する別の手段として、Remove メソッドまたは Clear メソッドも使用できます。

新しい Control オブジェクトをコレクションに追加するには、Add メソッドまたは AddRange メソッドを使用します。

使用例

派生クラス Panel の Control.ControlCollection 内のコレクション数が 0 より大きい場合に、コレクション内の最初の Control を削除するコード例を次に示します。この例では、Form 上に、Panel、Button、および 1 つ以上のその他のコントロールが作成されている必要があります。その他のコントロールは Panel コントロールに追加され、Panel コントロールは Form に追加されます。ボタンがクリックされると、パネルに含まれている最初のコントロールが Control.ControlCollection から削除されます。

Visual Basic

' Remove the first control in the collection.
Private Sub RemoveAtButton_Click(ByVal
 sender As System.Object, _
    ByVal e As System.EventArgs) Handles
 RemoveAtButton.Click
    If (Panel1.Controls.Count > 0) Then
        Panel1.Controls.RemoveAt(0)
    End If
End Sub

C#

// Remove the first control in the collection.
private void removeAtButton_Click(object sender,
 System.EventArgs e)
{
   if (panel1.Controls.Count > 0)
   {
      panel1.Controls.RemoveAt(0);
   }
}

C++

   // Remove the first control in the collection.
private:
   void removeAtButton_Click( Object^ /*sender*/, System::EventArgs^
 /*e*/ )
   {
      if ( panel1->Controls->Count > 0 )
      {
         panel1->Controls->RemoveAt( 0 );
      }
   }

J#

// Remove the first control in the collection.
private void removeAtButton_Click(Object sender,
 System.EventArgs e)
{
    if (panel1.get_Controls().get_Count() > 0) {
        panel1.get_Controls().RemoveAt(0);
    }
} //removeAtButton_Click

プラットフォーム

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