Excel.WorksheetFormulaChangedEventArgs interface
Stellt Informationen über das Arbeitsblatt und Formeln bereit, die das Formeländerungsereignis ausgelöst haben.
Hinweise
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 eine Größenbeschränkung überschreitet, |
| source | Die Quelle des Ereignisses. Dies kann lokal oder remote sein (durch gemeinsame Dokumenterstellung). |
| type | Ruft den Typ des Ereignisses ab. Weitere Informationen finden Sie unter |
| 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 eine Größenbeschränkung ü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 sein (durch gemeinsame Dokumenterstellung).
source: Excel.EventSource | "Local" | "Remote";Eigenschaftswert
Excel.EventSource | "Local" | "Remote"
Hinweise
type
Ruft den Typ des Ereignisses ab. Weitere Informationen finden Sie unter 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