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
- name
Tipo: System.String
O nome do controle a ser removido da instância de ControlCollection .
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
- Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.