Partager via


ControlCollection.Remove, méthode (String)

Supprime le contrôle portant le nom spécifié de l'instance de ControlCollection.

Espace de noms :  Microsoft.Office.Tools.Excel
Assembly :  Microsoft.Office.Tools.Excel (dans Microsoft.Office.Tools.Excel.dll)

Syntaxe

'Déclaration
Function Remove ( _
    name As String _
) As Boolean
bool Remove(
    string name
)

Paramètres

Valeur de retour

Type : System.Boolean

Notes

Les contrôles qui ont été ajoutés au moment du design ne peuvent pas être supprimés de l'instance de ControlCollection. Vous pouvez seulement utiliser la méthode Remove pour supprimer les contrôles ajoutés au moment de l'exécution.

Exemples

L'exemple de code suivant ajoute un contrôle Button et un contrôle MonthCalendar à la feuille de calcul. Lorsque l'utilisateur clique sur le bouton, le code supprime le contrôle MonthCalendar.

Private Sub ExcelControlRemove()

    Dim Button1 As Microsoft.Office.Tools.Excel. _
        Controls.Button = Me.Controls.AddButton( _
        0, 0, 56.25, 17.25, "Button1")
    Dim MonthCalendar1 As Microsoft.Office.Tools. _
        Excel.Controls.MonthCalendar = Me.Controls. _
        AddMonthCalendar(0, 20, 75, 15, "MonthCalendar1")

    Button1.Text = "Remove"

    AddHandler Button1.Click, AddressOf Button1_Click

End Sub
Private Sub Button1_Click(ByVal sender As Object, ByVal e As _
    EventArgs)

    Me.Controls.Remove("MonthCalendar1")

End Sub
private void ExcelControlRemove()
{

    Microsoft.Office.Tools.Excel.Controls.Button button1 =
        this.Controls.AddButton(0, 0, 56.25, 17.25,
        "button1");
    Microsoft.Office.Tools.Excel.Controls.MonthCalendar
         monthCalendar1 = this.Controls.AddMonthCalendar(
         0, 20, 75, 15, "monthCalendar1");
    button1.Text = "Remove";
    button1.Click += new EventHandler(button1_Click);

}

void button1_Click(object sender, EventArgs e)
{
    this.Controls.Remove("monthCalendar1");
}

Sécurité .NET Framework

Voir aussi

Référence

ControlCollection Interface

Remove, surcharge

Microsoft.Office.Tools.Excel, espace de noms