Word.SelectionInsertFormulaOptions interface

Pacote:

word

Representa as opções para o método Selection.insertFormula .

Comentários

[ Conjunto de API: WordApiDesktop 1.4 ]

Exemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/word/55-selection/insert-formula.yaml

// Inserts a SUM formula with a currency number format at the selection.
// The selection must be in a table cell.
await Word.run(async (context) => {
  const options: Word.SelectionInsertFormulaOptions = {
    formula: "=SUM(ABOVE)",
    numberFormat: "$#,##0.00",
  };
  context.document.selection.insertFormula(options);
  await context.sync();

  console.log("Inserted =SUM(ABOVE) with currency format.");
});

Propriedades

formula

Se for fornecido, especifica a fórmula matemática que pretende que o campo = (Fórmula) avalie. A formula propriedade só é opcional se a seleção estiver numa célula e existir pelo menos uma célula que contenha 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 é {=SUM(ABOVE)}; se as células à esquerda do ponto de inserção contiverem valores, o campo inserido é {=SUM(LEFT)}. Se ambas as células acima do ponto de inserção e as células à esquerda contiverem valores, o Microsoft Word utiliza as seguintes regras para determinar qual SUM a função a inserir. Se a célula imediatamente acima do ponto de inserção contiver um valor, Word insere {=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 o fizer, Word insere {=SUM(LEFT)}. Se nenhuma célula imediatamente acima do ponto de inserção nem a célula imediatamente abaixo dela contiver um valor, Word insere {=SUM(ABOVE)}. Se não especificar a formula propriedade e todas as células acima e à esquerda do ponto de inserção estiverem vazias, utilizar o = (Formula) campo causará um erro.

numberFormat

Se for fornecido, especifica o formato para o resultado do = (Formula) campo.

Detalhes da propriedade

formula

Se for fornecido, especifica a fórmula matemática que pretende que o campo = (Fórmula) avalie. A formula propriedade só é opcional se a seleção estiver numa célula e existir pelo menos uma célula que contenha 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 é {=SUM(ABOVE)}; se as células à esquerda do ponto de inserção contiverem valores, o campo inserido é {=SUM(LEFT)}. Se ambas as células acima do ponto de inserção e as células à esquerda contiverem valores, o Microsoft Word utiliza as seguintes regras para determinar qual SUM a função a inserir.

• Se a célula imediatamente acima do ponto de inserção contiver um valor, Word insere {=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 o fizer, Word insere {=SUM(LEFT)}.

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

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

formula?: string;

Valor da propriedade

string

Comentários

[ Conjunto de API: WordApiDesktop 1.4 ]

numberFormat

Se for fornecido, especifica o formato para o resultado do = (Formula) campo.

numberFormat?: string;

Valor da propriedade

string

Comentários

[ Conjunto de API: WordApiDesktop 1.4 ]