Control.ControlCollection.Remove(Control) Метод

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

Control.ControlCollection.cs

Удаляет указанный элемент управления из коллекции элементов управления.

public:
 virtual void Remove(System::Windows::Forms::Control ^ value);

public virtual void Remove(System.Windows.Forms.Control? value);

abstract member Remove : System.Windows.Forms.Control -> unit
override this.Remove : System.Windows.Forms.Control -> unit

Public Overridable Sub Remove (value As Control)

Параметры

value

Control

Удаление Control из .Control.ControlCollection

Примеры

В следующем примере кода удаляется Control из Control.ControlCollection производного класса Panel , если он является членом коллекции. В примере требуется, чтобы вы создали Panelэлемент управления , а Buttonтакже один или несколько RadioButton элементов управления.Form Элементы 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

Комментарии

Control При удалении из коллекции элементов управления все последующие элементы управления перемещаются вверх по одной позиции в коллекции.

Вы также можете удалить объект Control с помощью RemoveAt метода или удалить все элементы управления с помощью Clear метода.

Чтобы добавить новые Control объекты в коллекцию, используйте Add методы или AddRange методы.

Примечания для тех, кто наследует этот метод

При переопределении Remove(Control) в производном классе обязательно вызовите метод базового класса Remove(Control) , чтобы убедиться, что элемент управления удаляется из коллекции.

См. также

• RemoveAt(Int32)
• Clear()
• Add(Control)