Excel.WorksheetFormulaChangedEventArgs interface
Enthält Informationen über das Arbeitsblatt und die Formeln, die das Ereignis "Formeländerung" ausgelöst haben.
Hinweise
Verwendet von
Beispiele
async function registerFormulaChangeHandler() {
await Excel.run(async (context) => {
// Register the formula changed event handler for the Sample worksheet.
let sheet = context.workbook.worksheets.getItem("Sample");
sheet.onFormulaChanged.add(formulaChangeHandler);
await context.sync();
});
}
async function formulaChangeHandler(event: Excel.WorksheetFormulaChangedEventArgs) {
await Excel.run(async (context) => {
// Retrieve details about the formula change event.
const cellAddress = event.formulaDetails[0].cellAddress;
const previousFormula = event.formulaDetails[0].previousFormula;
const source = event.source;
// Print out the change event details.
console.log(
`The formula in cell ${cellAddress} changed.
The previous formula was: ${previousFormula}.
The source of the change was: ${source}.`
);
});
}
Eigenschaften
| formula |
Ruft ein Array von Wenn die Anzahl der geänderten Formeln oder die Größe des geänderten Formeltexts ein Größenlimit überschreitet, |
| source | Die Quelle des Ereignisses. Dies kann lokal oder remote (durch gemeinsame Dokumenterstellung) erfolgen. |
| type | Ruft den Typ des Ereignisses ab. Weitere Informationen findest du hier |
| worksheet |
Ruft die ID des Arbeitsblatts ab, in dem die Formel geändert wurde. |
Details zur Eigenschaft
formulaDetails
Ruft ein Array von FormulaChangedEventDetail Objekten ab, die die Details zu allen geänderten Formeln enthalten.
Wenn die Anzahl der geänderten Formeln oder die Größe des geänderten Formeltexts ein Größenlimit überschreitet, formulaDetails wird undefiniert zurückgegeben. Dies weist darauf hin, dass sich etwas auf dem Blatt geändert hat, aber die Details nicht gemeldet werden können.
formulaDetails: Excel.FormulaChangedEventDetail[];
Eigenschaftswert
Hinweise
source
Die Quelle des Ereignisses. Dies kann lokal oder remote (durch gemeinsame Dokumenterstellung) erfolgen.
source: Excel.EventSource | "Local" | "Remote";
Eigenschaftswert
Excel.EventSource | "Local" | "Remote"
Hinweise
type
Ruft den Typ des Ereignisses ab. Weitere Informationen findest du hier Excel.EventType .
type: "WorksheetFormulaChanged";
Eigenschaftswert
"WorksheetFormulaChanged"
Hinweise
worksheetId
Ruft die ID des Arbeitsblatts ab, in dem die Formel geändert wurde.
worksheetId: string;
Eigenschaftswert
string