Word.SelectionInsertFormulaOptions interface

Представляет параметры метода Selection.insertFormula .

Комментарии

Набор API: WordApiDesktop 1.4

Используется

Примеры

// 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.");
});

Свойства

formula

Если указано, указывает математическую формулу, которую необходимо вычислить полю = (формула). Свойство formula является необязательным только в том случае, если выделенный фрагмент находится в ячейке и хотя бы одна ячейка содержит значение выше или слева от ячейки, содержащей точку вставки. Если ячейки выше точки вставки содержат значения, вставляется поле {=SUM(ABOVE)}; если ячейки слева от точки вставки содержат значения, вставляется поле {=SUM(LEFT)}. Если значения содержатся в ячейках над точкой вставки и слева от нее, Microsoft Word использует указанные ниже правила для определения SUM функции, которую следует вставить.

  • Если ячейка непосредственно над точкой вставки содержит значение, Word вставляет {=SUM(ABOVE)}.

  • Если ячейка, расположенная непосредственно над точкой вставки, не содержит значения, а ячейка непосредственно слева от нее содержит, приложение Word вставляет {=SUM(LEFT)}.

  • Если ни одна из ячеек, расположенных непосредственно над точкой вставки, и ячейка, непосредственно расположенная ниже, не содержит значения, выполняется вставка {=SUM(ABOVE)}Word .

  • Если это свойство не указано formula и все ячейки выше и слева от точки вставки пусты, при использовании этого = (Formula) поля возникает ошибка.

numberFormat

Если указан, определяет формат результата = (Formula) поля.

Сведения о свойстве

formula

Если указано, указывает математическую формулу, которую необходимо вычислить полю = (формула). Свойство formula является необязательным только в том случае, если выделенный фрагмент находится в ячейке и хотя бы одна ячейка содержит значение выше или слева от ячейки, содержащей точку вставки. Если ячейки выше точки вставки содержат значения, вставляется поле {=SUM(ABOVE)}; если ячейки слева от точки вставки содержат значения, вставляется поле {=SUM(LEFT)}. Если значения содержатся в ячейках над точкой вставки и слева от нее, Microsoft Word использует указанные ниже правила для определения SUM функции, которую следует вставить.

  • Если ячейка непосредственно над точкой вставки содержит значение, Word вставляет {=SUM(ABOVE)}.

  • Если ячейка, расположенная непосредственно над точкой вставки, не содержит значения, а ячейка непосредственно слева от нее содержит, приложение Word вставляет {=SUM(LEFT)}.

  • Если ни одна из ячеек, расположенных непосредственно над точкой вставки, и ячейка, непосредственно расположенная ниже, не содержит значения, выполняется вставка {=SUM(ABOVE)}Word .

  • Если это свойство не указано formula и все ячейки выше и слева от точки вставки пусты, при использовании этого = (Formula) поля возникает ошибка.

formula?: string;

Значение свойства

string

Комментарии

Набор API: WordApiDesktop 1.4

numberFormat

Если указан, определяет формат результата = (Formula) поля.

numberFormat?: string;

Значение свойства

string

Комментарии

Набор API: WordApiDesktop 1.4