Método ControlCollection.RemoveAt

Artigo
05/21/2013

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

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

Exceções

Exceção	Condição
ArgumentOutOfRangeException	index é menor que zero ou index é igual a ou maior do 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 RemoveAt para remover apenas 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 ao documento, e remove o controle de Button .

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