Excel.WorksheetFormulaChangedEventArgs interface

Paquete:

excel

Proporciona información sobre la hoja de cálculo y las fórmulas que generaron el evento de cambio de fórmula.

Comentarios

[ Conjunto de API: ExcelApi 1.13 ]

Ejemplos

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

Propiedades

formulaDetails	Obtiene una matriz de FormulaChangedEventDetail objetos, que contienen los detalles sobre todas las fórmulas modificadas. Si el número de fórmulas modificadas o el tamaño del texto de la fórmula modificada supera un límite de tamaño, formulaDetails devuelve undefined. Esto indica que algo en la hoja ha cambiado, pero no se pueden notificar los detalles.
source	Origen del evento. Puede ser local o remota (a través de la coautoría).
type	Obtiene el tipo del evento. Vea Excel.EventType para más información.
worksheetId	Obtiene el identificador de la hoja de cálculo en la que cambió la fórmula.

Detalles de las propiedades

formulaDetails

Obtiene una matriz de FormulaChangedEventDetail objetos, que contienen los detalles sobre todas las fórmulas modificadas.

Si el número de fórmulas modificadas o el tamaño del texto de la fórmula modificada supera un límite de tamaño, formulaDetails devuelve undefined. Esto indica que algo en la hoja ha cambiado, pero no se pueden notificar los detalles.

formulaDetails: Excel.FormulaChangedEventDetail[];

Valor de propiedad

Excel.FormulaChangedEventDetail[]

Comentarios

[ Conjunto de API: ExcelApi 1.13 ]

source

Origen del evento. Puede ser local o remota (a través de la coautoría).

source: Excel.EventSource | "Local" | "Remote";

Valor de propiedad

Excel.EventSource | "Local" | "Remote"

Comentarios

[ Conjunto de API: ExcelApi 1.13 ]

type

Obtiene el tipo del evento. Vea Excel.EventType para más información.

type: "WorksheetFormulaChanged";

Valor de propiedad

"WorksheetFormulaChanged"

Comentarios

[ Conjunto de API: ExcelApi 1.13 ]

worksheetId

Obtiene el identificador de la hoja de cálculo en la que cambió la fórmula.

worksheetId: string;

Valor de propiedad

string

Comentarios

[ Conjunto de API: ExcelApi 1.13 ]