Método ControlCollection.RemoveAt
Remove o controle no índice especificado na ControlCollection instância.
Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (em Microsoft.Office.Tools.Excel.dll)
Sintaxe
'Declaração
Sub RemoveAt ( _
index As Integer _
)
void RemoveAt(
int index
)
Parâmetros
- index
Tipo: System.Int32
O índice baseado em zero do controle para remover o ControlCollection instância.
Exceções
| Exceção | Condição |
|---|---|
| ArgumentOutOfRangeException | Índice é menor do que zero ou o índice é igual ou maior que a contagem. |
Comentários
Controles que foram adicionados em tempo de design não podem ser removidos do ControlCollection instância. Você só pode usar o RemoveAt método para remover os controles adicionados em tempo de execução.
Exemplos
O exemplo de código a seguir adiciona um Button controle e um MonthCalendar o controle para a planilha. Quando o botão é clicado, o código remove a MonthCalendar controle especificado pelo í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);
}
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áveis.