Control.ControlCollection.Remove(Control) Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Odebere zadaný ovládací prvek z kolekce ovládacích prvků.

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

Objekt Control , který se má odebrat z objektu Control.ControlCollection.

Příklady

Následující příklad kódu odebere Control z Control.ControlCollection odvozené třídy Panel , pokud je členem kolekce. Příklad vyžaduje, abyste na objektu PanelButtonvytvořili , a jeden nebo více RadioButton ovládacích prvků Form. Ovládací RadioButton prvky se přidají do Panel ovládacího prvku a Panel ovládací prvek se přidá do .Form Po kliknutí na tlačítko se z přepínače odebere Control.ControlCollectionpřepínač s názvem radioButton2 .

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

Poznámky

Control Při odebrání z kolekce ovládacích prvků se všechny následné ovládací prvky přesunou o jednu pozici v kolekci.

Můžete také odebrat Control pomocí RemoveAt metody nebo odebrat všechny ovládací prvky pomocí Clear metody .

Pokud chcete do kolekce přidat nové Control objekty, použijte Add metody nebo AddRange .

Poznámky pro dědice

Při přepsání Remove(Control) v odvozené třídě nezapomeňte volat metodu základní třídy Remove(Control) , aby se zajistilo odebrání ovládacího prvku z kolekce.

Viz také

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