Partilhar via


Método ControlCollection.Remove (String)

Remove o controle com o nome especificado da instância de ControlCollection .

Namespace:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel (em Microsoft.Office.Tools.Excel.dll)

Sintaxe

'Declaração
Function Remove ( _
    name As String _
) As Boolean
bool Remove(
    string name
)

Parâmetros

Valor de retorno

Tipo: System.Boolean

Comentários

Controles que foram adicionados em tempo de design não podem ser removidos da instância de ControlCollection .Você pode usar o método de Remove para remover os controles adicionados em tempo de execução.

Exemplos

O exemplo de código a seguir adiciona um controle de Button e um controle de MonthCalendar a planilha.Quando o botão é clicado, o código remove o controle de 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");
}

Segurança do .NET Framework

Consulte também

Referência

ControlCollection Interface

Sobrecargas Remove

Namespace Microsoft.Office.Tools.Excel