Word.SelectionInsertFormulaOptions interface

Paket:
word

Stellt die Optionen für die Selection.insertFormula-Methode dar.

Hinweise

API-Satz: WordApiDesktop 1.4

Verwendet von

Beispiele

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

Eigenschaften

formula

Gibt (falls angegeben) die mathematische Formel an, die das Feld "=" (Formel) auswerten soll. Die formula Eigenschaft ist nur dann optional, wenn sich die Markierung in einer Zelle befindet und mindestens eine Zelle mit einem Wert oberhalb oder links der Zelle vorhanden ist, die die Einfügemarke enthält. Wenn die Zellen oberhalb der Einfügemarke Werte enthalten, ist {=SUM(ABOVE)}das eingefügte Feld ; enthalten die Zellen links von der Einfügemarke Werte, ist {=SUM(LEFT)}das eingefügte Feld . Wenn sowohl die Zellen oberhalb als auch die Zellen links davon Werte enthalten, bestimmt Microsoft Word anhand der folgenden Regeln, welche SUM Funktion eingefügt werden soll.

  • Wenn die Zelle unmittelbar über der Einfügemarke einen Wert enthält, fügt Word ein{=SUM(ABOVE)}.

  • Enthält die Zelle unmittelbar oberhalb der Einfügemarke keinen Wert, die unmittelbar links von der Einfügemarke aber die Zelle, die unmittelbar links von der Einfügemarke liegt, fügt Word ein{=SUM(LEFT)}.

  • Wenn weder die unmittelbar über der Einfügemarke noch die unmittelbar darunter liegende Zelle einen Wert enthält, fügt Word ein{=SUM(ABOVE)}.

  • Wenn Sie die formula Eigenschaft nicht angeben und alle Zellen oberhalb und links der Einfügemarke leer sind, führt die Verwendung des = (Formula) Felds zu einem Fehler.
numberFormat

Gibt (falls angegeben) das Format für das Ergebnis des Felds = (Formula) an.

Details zur Eigenschaft

formula

Gibt (falls angegeben) die mathematische Formel an, die das Feld "=" (Formel) auswerten soll. Die formula Eigenschaft ist nur dann optional, wenn sich die Markierung in einer Zelle befindet und mindestens eine Zelle mit einem Wert oberhalb oder links der Zelle vorhanden ist, die die Einfügemarke enthält. Wenn die Zellen oberhalb der Einfügemarke Werte enthalten, ist {=SUM(ABOVE)}das eingefügte Feld ; enthalten die Zellen links von der Einfügemarke Werte, ist {=SUM(LEFT)}das eingefügte Feld . Wenn sowohl die Zellen oberhalb als auch die Zellen links davon Werte enthalten, bestimmt Microsoft Word anhand der folgenden Regeln, welche SUM Funktion eingefügt werden soll.

  • Wenn die Zelle unmittelbar über der Einfügemarke einen Wert enthält, fügt Word ein{=SUM(ABOVE)}.

  • Enthält die Zelle unmittelbar oberhalb der Einfügemarke keinen Wert, die unmittelbar links von der Einfügemarke aber die Zelle, die unmittelbar links von der Einfügemarke liegt, fügt Word ein{=SUM(LEFT)}.

  • Wenn weder die unmittelbar über der Einfügemarke noch die unmittelbar darunter liegende Zelle einen Wert enthält, fügt Word ein{=SUM(ABOVE)}.

  • Wenn Sie die formula Eigenschaft nicht angeben und alle Zellen oberhalb und links der Einfügemarke leer sind, führt die Verwendung des = (Formula) Felds zu einem Fehler.

formula?: string;

Eigenschaftswert

string

Hinweise

API-Satz: WordApiDesktop 1.4

numberFormat

Gibt (falls angegeben) das Format für das Ergebnis des Felds = (Formula) an.

numberFormat?: string;

Eigenschaftswert

string

Hinweise

API-Satz: WordApiDesktop 1.4