Condividi tramite


Control.ControlCollection.Remove(Control) Metodo

Definizione

Rimuove il controllo specificato dall'insieme dei controlli.

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)

Parametri

value
Control

Oggetto Control da rimuovere da Control.ControlCollection.

Esempio

Nell'esempio di codice seguente viene rimosso un Control oggetto dall'oggetto Control.ControlCollection della classe Panel derivata se è un membro della raccolta. L'esempio richiede che sia stato creato un Paneloggetto , un Buttone uno o più RadioButton controlli in un oggetto Form. I RadioButton controlli vengono aggiunti al Panel controllo e il Panel controllo viene aggiunto a Form. Quando si fa clic sul pulsante , il pulsante di opzione denominato radioButton2 viene rimosso da 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

Commenti

Quando un oggetto Control viene rimosso dalla raccolta di controlli, tutti i controlli successivi vengono spostati verso l'alto di una posizione nella raccolta.

È anche possibile rimuovere un Control oggetto utilizzando il RemoveAt metodo oppure rimuovere tutti i controlli usando il Clear metodo .

Per aggiungere nuovi Control oggetti alla raccolta, utilizzare i Add metodi o AddRange .

Note per gli eredi

Quando si esegue l'override Remove(Control) in una classe derivata, assicurarsi di chiamare il metodo della classe di Remove(Control) base per assicurarsi che il controllo venga rimosso dalla raccolta.

Si applica a

Vedi anche