Control.ControlCollection.Remove(Control) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Удаляет указанный элемент управления из коллекции.
public:
virtual void Remove(System::Windows::Forms::Control ^ value);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 -> unitPublic 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) , чтобы убедиться, что элемент управления удален из коллекции.
