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

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.

Consulte também

Referência

ControlCollection Interface

Namespace Microsoft.Office.Tools.Excel