ControlCollection.RemoveAt (Método)
Quita el control en el índice especificado en 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
Sub RemoveAt ( _
index As Integer _
)
void RemoveAt(
int index
)
Parámetros
- index
Tipo: System.Int32
Índice de base cero del control que se debe quitar de la instancia de ControlCollection.
Excepciones
| Excepción | Condición |
|---|---|
| ArgumentOutOfRangeException | El índice es menor que cero o igual o mayor que el recuento. |
Comentarios
No pueden quitarse de la instancia de ControlCollection controles agregados en tiempo de diseño. El método RemoveAt 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. Cuando se hace clic en el botón, el código quita el control MonthCalendar especificado por el índice.
Private Sub ExcelControlRemoveAt()
Dim Button2 As Microsoft.Office.Tools.Excel. _
Controls.Button = Me.Controls.AddButton( _
0, 0, 56.25, 17.25, "Button2")
Dim MonthCalendar1 As Microsoft.Office.Tools. _
Excel.Controls.MonthCalendar = Me.Controls. _
AddMonthCalendar(0, 20, 75, 15, "MonthCalendar1")
Button2.Text = "Remove"
AddHandler Button2.Click, AddressOf Button2_Click
End Sub
Private Sub Button2_Click(ByVal sender As Object, ByVal e _
As EventArgs)
Me.Controls.RemoveAt(1)
End Sub
private void ExcelControlRemoveAt()
{
Microsoft.Office.Tools.Excel.Controls.Button button2 =
this.Controls.AddButton(0, 0, 56.25, 17.25,
"button2");
Microsoft.Office.Tools.Excel.Controls.MonthCalendar
monthCalendar1 = this.Controls.AddMonthCalendar(
0, 20, 75, 15, "monthCalendar1");
button2.Text = "Remove";
button2.Click += new EventHandler(button2_Click);
}
void button2_Click(object sender, EventArgs e)
{
this.Controls.RemoveAt(1);
}
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.