Excel.WorksheetFormulaChangedEventArgs interface
Fornece informações sobre a folha de cálculo e as fórmulas que geraram o evento de alteração da fórmula.
Comentários
[ Conjunto de API: ExcelApi 1.13 ]
Exemplos
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}.`
);
});
}
Propriedades
| formula |
Obtém uma matriz de Se o número de fórmulas alteradas ou o tamanho do texto da fórmula alterado exceder um limite de tamanho, |
| source | A origem do evento. Pode ser local ou remoto (através da cocriação). |
| type | Obtém o tipo do evento. Veja |
| worksheet |
Obtém o ID da folha de cálculo na qual a fórmula foi alterada. |
Detalhes da propriedade
formulaDetails
Obtém uma matriz de FormulaChangedEventDetail objetos, que contêm os detalhes sobre todas as fórmulas alteradas.
Se o número de fórmulas alteradas ou o tamanho do texto da fórmula alterado exceder um limite de tamanho, formulaDetails devolve indefinido. Isto indica que algo na folha foi alterado, mas não é possível reportar os detalhes.
formulaDetails: Excel.FormulaChangedEventDetail[];Valor da propriedade
Comentários
source
A origem do evento. Pode ser local ou remoto (através da cocriação).
source: Excel.EventSource | "Local" | "Remote";Valor da propriedade
Excel.EventSource | "Local" | "Remote"
Comentários
type
Obtém o tipo do evento. Veja Excel.EventType para obter detalhes.
type: "WorksheetFormulaChanged";Valor da propriedade
"WorksheetFormulaChanged"
Comentários
worksheetId
Obtém o ID da folha de cálculo na qual a fórmula foi alterada.
worksheetId: string;Valor da propriedade
string