Control.ControlCollection.Remove メソッドとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

Control.ControlCollection.Remove メソッド

指定したコントロールをコントロールコレクションから削除します。

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

Visual Basic (宣言)

Public Overridable Sub Remove
 ( _
    value As Control _
)

Visual Basic (使用法)

Dim instance As ControlCollection
Dim value As Control

instance.Remove(value)

public virtual void Remove (
    Control value
)

C++

public:
virtual void Remove (
    Control^ value
)

public void Remove (
    Control value
)

JScript

public function Remove (
    value : Control
)

パラメータ

value: Control.ControlCollection から削除する Control。

解説

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

RemoveAt メソッドを使用しても、Control を削除できます。また Clear メソッドを使用すると、すべてのコントロールを削除できます。

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

継承時の注意 派生クラスで Remove をオーバーライドする場合は、基本クラスの Remove メソッドを呼び出して、確実にコントロールがコレクションから削除されるようにしてください。

使用例

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

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

// 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