Control.ControlCollection.Remove(Control) Méthode

  • Référence

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Supprime le contrôle spécifié de la collection de contrôles.

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)

Paramètres

value
Control

Control à supprimer de Control.ControlCollection.

Exemples

L’exemple de code suivant supprime un Control de la Control.ControlCollection classe Panel dérivée s’il est membre de la collection. L’exemple nécessite que vous ayez créé un Panel, un Buttonou plusieurs RadioButton contrôles sur un Form. Les RadioButton contrôles sont ajoutés au Panel contrôle et le Panel contrôle est ajouté au Formcontrôle. Lorsque le bouton est cliqué, la case d’option nommée radioButton2 est supprimée du 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

Remarques

Lorsqu’un Control contrôle est supprimé de la collection de contrôles, tous les contrôles suivants sont déplacés vers le haut d’une position dans la collection.

Vous pouvez également supprimer une Control RemoveAt méthode ou supprimer tous les contrôles à l’aide de la Clear méthode.

Pour ajouter de nouveaux Control objets à la collection, utilisez le ou AddRange les Add méthodes.

Notes pour les héritiers

En cas de Remove(Control) substitution dans une classe dérivée, veillez à appeler la méthode de la classe de Remove(Control) base pour vous assurer que le contrôle est supprimé de la collection.

S’applique à

Voir aussi