ControlCollection.Remove (Método) (String)
Quita el control con el nombre especificado de la instancia de ControlCollection.
Espacio de nombres: Microsoft.Office.Tools.Excel
Ensamblado: Microsoft.Office.Tools.Excel (en Microsoft.Office.Tools.Excel.dll)
Sintaxis
'Declaración
Function Remove ( _
name As String _
) As Boolean
bool Remove(
string name
)
Parámetros
- name
Tipo: System.String
Nombre del control que se va a quitar de la instancia de ControlCollection.
Valor devuelto
Tipo: System.Boolean
Comentarios
No pueden quitarse de la instancia de ControlCollection controles agregados en tiempo de diseño. El método Remove sólo se puede utilizar para quitar controles agregados en tiempo de ejecución.
Ejemplos
En el siguiente ejemplo de código se agregan un control Button y un control MonthCalendar a la hoja de cálculo. Al hacer clic en el botón, el código quita el control 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");
}
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.