Compartilhar via


Método ListRows.Add (Excel)

Adiciona uma nova linha à tabela representada pelo ListObject especificado.

Sintaxe

expressão. Adicionar (Posição, AlwaysInsert)

Expressão Uma variável que representa um objeto ListRows .

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Posição Opcional Variantes Número inteiro. Especifica a posição relativa da nova linha.
AlwaysInsert Opcional Variant Boolean. Especifica se os dados em células abaixo da última linha da tabela sempre devem ser deslocados quando a nova linha é inserida, mesmo que a linha abaixo dessa tabela esteja vazia. Se for True, as células abaixo da tabela serão deslocadas uma linha para baixo.

Se False, se a linha abaixo da tabela estiver vazia, a tabela se expandirá para ocupar essa linha sem alterar as células abaixo dela, mas se a linha abaixo da tabela contiver dados, essas células serão deslocadas para baixo quando a nova linha for inserida.

Valor de retorno

Um objeto ListRow que representa a nova linha.

Comentários

Se Position não for especificado, uma linha inferior será adicionada. Se AlwaysInsert não for especificado, as células abaixo da tabela serão deslocadas uma linha para baixo (equivale a especificar True).

Exemplo

O exemplo a seguir adiciona uma nova linha ao objeto ListObject padrão na primeira planilha da pasta de trabalho. Como nenhuma posição foi especificada, a nova linha é adicionada ao final da lista.

Set myNewRow = ActiveWorkbook.Worksheets(1).ListObject(1).ListRows.Add

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.