Share via

Método Selection.InsertFormula (Word)

  • Artigo

Insere um campo = (Formula contendo uma fórmula na seleção.

Sintaxe

expressão. Fórmula (Fórmula, NumberFormat)

expressão Obrigatório. Uma variável que representa um objeto Selection.

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Fórmula Opcional Variant A fórmula matemática que você deseja que seja avaliada pelo campo = (Formula). Referências como as de planilha são válidas para células de tabela. Por exemplo, "=SUM(A4:C4)" especifica os três primeiros valores na quarta linha. Para obter mais informações sobre o campo = (Formula), consulte Códigos de campo: campo = (Formula).
NumberFormat Opcional Variant A format for the result of the = (Formula) field. Para obter informações sobre os tipos de formatos que você pode aplicar, consulte a opção de campo Imagem Numérica (#).

Comentários

A fórmula substituirá a seleção, se ela não estiver recolhida.

Se você estiver usando um aplicativo de planilha, como o Microsoft Office Excel, a incorporação de toda uma planilha ou parte dela em um documento costuma ser mais fácil que usar o campo = (Formula) em uma tabela.

O argumento Formula será opcional somente se a seleção estiver em uma célula e houver pelo menos uma célula contendo um valor acima ou à esquerda da célula que contém o ponto de inserção. Se as células acima do ponto de inserção contiverem valores, o campo inserido será {=SUM(ABOVE)}; se as células à esquerda do ponto de inserção contiverem valores, o campo inserido será {=SUM(LEFT)}. Se as células acima e à esquerda do ponto de inserção contiverem valores, o Microsoft Word usará as seguintes regras para determinar a função SUM a ser inserida:

  • Se a célula imediatamente acima do ponto de inserção contiver um valor, o Word inserirá {=SUM(ABOVE)}.

  • Se a célula imediatamente acima do ponto de inserção não contiver um valor mas a célula imediatamente à esquerda do ponto de inserção contiver, o Word inserirá {=SUM(LEFT)}.

  • Se nem a célula imediatamente acima nem a célula imediatamente abaixo do ponto de inserção contiver um valor, o Word inserirá {=SUM(ABOVE)}.

  • Se você não especificar Formula e todas as células acima e à esquerda do ponto de inserção estiverem vazias, o uso do campo = (Formula) causará um erro.

Exemplo

Este exemplo cria uma tabela com três linhas e três colunas no início do documento ativo e calcula a média de todos os números da primeira coluna.

Set MyRange = ActiveDocument.Range(0, 0) 
Set myTable = ActiveDocument.Tables.Add(MyRange, 3, 3) 
With myTable 
 .Cell(1, 1).Range.InsertAfter "100" 
 .Cell(2, 1).Range.InsertAfter "50" 
 .Cell(3, 1).Select 
End With 
Selection.InsertFormula Formula:="=Average(Above)"

O exemplo insere um campo de fórmula que é subtraído de um valor representado pelo indicador chamado "GrossSales". O resultado é formatado com um cifrão.

Selection.Collapse Direction:=wdCollapseStart 
Selection.InsertFormula Formula:= "=GrossSales-45,000.00", _ 
 NumberFormat:="$#,##0.00"

Confira também

Objeto Selection

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.