Compartilhar via


Método Range.Insert (Excel)

Insere uma célula ou um intervalo de células na planilha ou folha de macro e desloca as outras células para liberar espaço.

Sintaxe

expressão. Inserir (Shift, CopyOrigin)

expressão Uma variável que representa um objeto de Intervalo.

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Shift Opcional Variant Especifica como deslocar as células. Pode ser uma das seguintes constantes xlInsertShiftDirection : xlShiftToRight ou xlShiftDown. Se este argumento for omitido, o Microsoft Excel decidirá com base na forma do intervalo.
CopyOrigin Opcional Variant A origem da cópia; ou seja, de onde copiar o formato das células inseridas. Pode ser uma das seguintes constantes xlInsertFormatOrigin : xlFormatFromLeftOrAbove (predefinição) ou xlFormatFromRightOrBelow.

Valor de retorno

Variant

Comentários

Não existe nenhum valor para CopyOrigin que seja equivalente a Limpar Formatação ao inserir células interativamente no Excel. Para tal, utilize o método ClearFormats .

With Range("B2:E5")
    .Insert xlShiftDown
    .ClearFormats
End With

Exemplo

Este exemplo insere uma linha acima da linha 2, copiando o formato da linha abaixo (linha 3) em vez de a partir da linha de cabeçalho.

Range("2:2").Insert CopyOrigin:=xlFormatFromRightOrBelow

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.