Método ControlCollection.RemoveAt

Artigo
01/09/2014

Remove o controle no índice especificado na instância de ControlCollection .

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 com base zero do controle a ser removido da instância de ControlCollection .

Exceções

Exceção	Condição
ArgumentOutOfRangeException	O índice é menor que zero ou índice é igual a ou maior que a contagem.

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 RemoveAt 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 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ável.

Consulte também

Referência

ControlCollection Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via