Compartir a través de


Word.SelectionInsertFormulaOptions interface

Representa las opciones del método Selection.insertFormula .

Comentarios

[ Conjunto de API: WordApiDesktop 1.4 ]

Ejemplos

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

Propiedades

formula

Si se proporciona, especifica la fórmula matemática que desea que se evalúe el campo = (Fórmula ). La formula propiedad solo es opcional si la selección está en una celda y hay al menos una celda que contiene un valor anterior o a la izquierda de la celda que contiene el punto de inserción. Si las celdas situadas encima del punto de inserción contienen valores, el campo insertado es {=SUM(ABOVE)}; si las celdas situadas a la izquierda del punto de inserción contienen valores, el campo insertado es {=SUM(LEFT)}. Si las celdas situadas por encima del punto de inserción y las celdas situadas a la izquierda contienen valores, Microsoft Word usa las reglas siguientes para determinar qué SUM función se va a insertar.

  • Si la celda situada inmediatamente encima del punto de inserción contiene un valor, Word inserta {=SUM(ABOVE)}.

  • Si la celda inmediatamente encima del punto de inserción no contiene un valor, pero la celda inmediatamente a la izquierda del punto de inserción lo hace, Word inserta {=SUM(LEFT)}.

  • Si ninguna celda inmediatamente encima del punto de inserción ni la celda inmediatamente debajo de ella contiene un valor, Word inserta {=SUM(ABOVE)}.

  • Si no especifica la formula propiedad y todas las celdas anteriores y a la izquierda del punto de inserción están vacías, el uso del = (Formula) campo produce un error.

numberFormat

Si se proporciona, especifica el formato del resultado del = (Formula) campo.

Detalles de las propiedades

formula

Si se proporciona, especifica la fórmula matemática que desea que se evalúe el campo = (Fórmula ). La formula propiedad solo es opcional si la selección está en una celda y hay al menos una celda que contiene un valor anterior o a la izquierda de la celda que contiene el punto de inserción. Si las celdas situadas encima del punto de inserción contienen valores, el campo insertado es {=SUM(ABOVE)}; si las celdas situadas a la izquierda del punto de inserción contienen valores, el campo insertado es {=SUM(LEFT)}. Si las celdas situadas por encima del punto de inserción y las celdas situadas a la izquierda contienen valores, Microsoft Word usa las reglas siguientes para determinar qué SUM función se va a insertar.

  • Si la celda situada inmediatamente encima del punto de inserción contiene un valor, Word inserta {=SUM(ABOVE)}.

  • Si la celda inmediatamente encima del punto de inserción no contiene un valor, pero la celda inmediatamente a la izquierda del punto de inserción lo hace, Word inserta {=SUM(LEFT)}.

  • Si ninguna celda inmediatamente encima del punto de inserción ni la celda inmediatamente debajo de ella contiene un valor, Word inserta {=SUM(ABOVE)}.

  • Si no especifica la formula propiedad y todas las celdas anteriores y a la izquierda del punto de inserción están vacías, el uso del = (Formula) campo produce un error.

formula?: string;

Valor de propiedad

string

Comentarios

[ Conjunto de API: WordApiDesktop 1.4 ]

numberFormat

Si se proporciona, especifica el formato del resultado del = (Formula) campo.

numberFormat?: string;

Valor de propiedad

string

Comentarios

[ Conjunto de API: WordApiDesktop 1.4 ]