Método ControlCollection.RemoveAt

Artigo
08/01/2011

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

Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (em Microsoft.Office.Tools.Word.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	indexé menor que zero ou index é 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ê pode usar RemoveAt somente 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 o documento e remove o Button de controle.

Private Sub WordControlRemoveAt()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim Button1 As Microsoft.Office.Tools.Word.Controls.Button _
        = Me.Controls.AddButton(0, 0, 56.25F, 17.25F, "Button1")
    Dim MonthCalendar1 As Microsoft.Office.Tools.Word. _
        Controls.MonthCalendar = Me.Controls.AddMonthCalendar( _
        0, 20, 75, 15, "MonthCalendar1")
    Me.Controls.RemoveAt(0)
End Sub

private void WordControlRemoveAt()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Controls.Button button1 =
        this.Controls.AddButton(0, 0, 56.25F, 17.25F,
        "button1");
    Microsoft.Office.Tools.Word.Controls.MonthCalendar
         monthCalendar1 = this.Controls.AddMonthCalendar(
         0, 20, 75, 15, "monthCalendar1");
    this.Controls.RemoveAt(0);
}

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.Word

Partilhar via