Partager via

Word.SelectionInsertFormulaOptions interface

Paquet:
word

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

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

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

S’il est fourni, spécifie la formule mathématique que vous souhaitez que le champ = (Formule) évalue. La formula propriété est facultative uniquement si la sélection se trouve dans une cellule et qu’au moins une cellule 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 la SUM 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 immédiatement au-dessus du point d’insertion ne contient pas de valeur, mais que la cellule située immédiatement à gauche du point d’insertion, Word insère {=SUM(LEFT)}.

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

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

S’il est fourni, spécifie le format du résultat du = (Formula) champ.

Détails de la propriété

formula

S’il est fourni, spécifie la formule mathématique que vous souhaitez que le champ = (Formule) évalue. La formula propriété est facultative uniquement si la sélection se trouve dans une cellule et qu’au moins une cellule 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 la SUM 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 immédiatement au-dessus du point d’insertion ne contient pas de valeur, mais que la cellule située immédiatement à gauche du point d’insertion, Word insère {=SUM(LEFT)}.

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

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

formula?: string;

Valeur de propriété

string

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]

numberFormat

S’il est fourni, spécifie le format du résultat du = (Formula) champ.

numberFormat?: string;

Valeur de propriété

string

Remarques

[ Ensemble d’API : WordApiDesktop 1.4 ]