Word.SelectionInsertFormulaOptions interface

Paquet:
word

Représente les options de la méthode Selection.insertFormula .

Remarques

Jeu d’API : WordApiDesktop 1.4

Utilisateur

Exemples

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

Propriétés

formula

Le cas échéant, spécifie la formule mathématique à évaluer par le champ = (formule). La formula propriété est facultative uniquement si la sélection se trouve dans une cellule et qu’il existe au moins une cellule qui contient une valeur au-dessus ou à gauche de la cellule qui contient le point d’insertion. Si les cellules situées au-dessus du point d’insertion contiennent des valeurs, le champ inséré est {=SUM(ABOVE)}; si les cellules situées à gauche du point d’insertion contiennent des valeurs, le champ inséré est {=SUM(LEFT)}. Si les cellules situées au-dessus du point d’insertion et celles situées à gauche de celui-ci contiennent des valeurs, Microsoft Word utilise les règles suivantes pour déterminer SUM la fonction à insérer.

  • Si la cellule située juste au-dessus du point d’insertion contient une valeur, Word insère .{=SUM(ABOVE)}

  • Si la cellule située juste au-dessus du point d’insertion ne contient pas de valeur, contrairement à la cellule située immédiatement à gauche du point d’insertion, Word insère .{=SUM(LEFT)}

  • Si ni la cellule située juste au-dessus du point d’insertion ni celle située juste au-dessous ne contiennent de valeur, Word insère .{=SUM(ABOVE)}

  • Si vous ne spécifiez pas la formula propriété et que toutes les cellules au-dessus et à gauche du point d’insertion sont vides, l’utilisation du = (Formula) champ provoque une erreur.
numberFormat

Le cas échéant, spécifie le format du résultat du = (Formula) champ.

Détails de la propriété

formula

Le cas échéant, spécifie la formule mathématique à évaluer par le champ = (formule). La formula propriété est facultative uniquement si la sélection se trouve dans une cellule et qu’il existe au moins une cellule qui contient une valeur au-dessus ou à gauche de la cellule qui contient le point d’insertion. Si les cellules situées au-dessus du point d’insertion contiennent des valeurs, le champ inséré est {=SUM(ABOVE)}; si les cellules situées à gauche du point d’insertion contiennent des valeurs, le champ inséré est {=SUM(LEFT)}. Si les cellules situées au-dessus du point d’insertion et celles situées à gauche de celui-ci contiennent des valeurs, Microsoft Word utilise les règles suivantes pour déterminer SUM la fonction à insérer.

  • Si la cellule située juste au-dessus du point d’insertion contient une valeur, Word insère .{=SUM(ABOVE)}

  • Si la cellule située juste au-dessus du point d’insertion ne contient pas de valeur, contrairement à la cellule située immédiatement à gauche du point d’insertion, Word insère .{=SUM(LEFT)}

  • Si ni la cellule située juste au-dessus du point d’insertion ni celle située juste au-dessous ne contiennent de valeur, Word insère .{=SUM(ABOVE)}

  • Si vous ne spécifiez pas la formula propriété et que toutes les cellules au-dessus et à gauche du point d’insertion sont vides, l’utilisation du = (Formula) champ provoque une erreur.

formula?: string;

Valeur de propriété

string

Remarques

Jeu d’API : WordApiDesktop 1.4

numberFormat

Le cas échéant, spécifie le format du résultat du = (Formula) champ.

numberFormat?: string;

Valeur de propriété

string

Remarques

Jeu d’API : WordApiDesktop 1.4