Control.ControlCollection.Remove(Control) Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

Usuwa określoną kontrolkę z kolekcji kontrolek.

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 -> unit
Public Overridable Sub Remove (value As Control)

Parametry

value
Control

Element Control do usunięcia z obiektu Control.ControlCollection.

Przykłady

Poniższy przykład kodu usuwa element Control z Control.ControlCollection klasy Panel pochodnej, jeśli jest członkiem kolekcji. W przykładzie jest wymagane utworzenie kontrolki Panel, , Buttoni co najmniej jednej RadioButton kontrolki w elemecie Form. Kontrolki RadioButton są dodawane do kontrolki Panel , a kontrolka Panel jest dodawana do elementu Form. Po kliknięciu przycisku przycisk radiowy o nazwie radioButton2 zostanie usunięty z elementu 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

Uwagi

Gdy obiekt Control zostanie usunięty z kolekcji kontrolek, wszystkie kolejne kontrolki zostaną przeniesione w górę o jedną pozycję w kolekcji.

Można również usunąć Control obiekt przy użyciu RemoveAt metody lub usunąć wszystkie kontrolki Clear przy użyciu metody .

Aby dodać nowe Control obiekty do kolekcji, użyj Add metod lub AddRange .

Uwagi dotyczące dziedziczenia

Podczas zastępowania Remove(Control) w klasie pochodnej należy wywołać metodę klasy Remove(Control) bazowej, aby upewnić się, że kontrolka została usunięta z kolekcji.

Dotyczy

Zobacz też