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.