Excel.WorksheetChangedEventArgs interface

Paquete:

excel

Proporciona información sobre la hoja de cálculo que generó el evento modificado.

Comentarios

[ Conjunto de API: ExcelApi 1.7 ]

Propiedades

address	Obtiene la dirección del intervalo que representa el área que ha cambiado en una hoja de cálculo específica.
changeType	Obtiene el tipo de cambio que representa cómo se desencadena el evento modificado. Vea Excel.DataChangeType para más información.
details	Representa la información sobre los detalles del cambio. Esta propiedad se puede recuperar cuando se desencadena el evento modificado en una sola celda. Si el evento modificado se desencadena en varias celdas, esta propiedad no se puede recuperar.
source	Obtiene el origen del evento. Vea Excel.EventSource para más información.
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 cambiaron los datos.

Métodos

getRange(ctx)	Obtiene el intervalo que representa el área que ha cambiado en una hoja de cálculo específica. [ Conjunto de API: ExcelApi 1.8 ]
getRangeOrNullObject(ctx)	Obtiene el intervalo que representa el área que ha cambiado en una hoja de cálculo específica. Puede devolver un objeto null. [ Conjunto de API: ExcelApi 1.8 ]

Detalles de las propiedades

address

Obtiene la dirección del intervalo que representa el área que ha cambiado en una hoja de cálculo específica.

address: string;

Valor de propiedad

string

Comentarios

[ Conjunto de API: ExcelApi 1.7 ]

changeType

Obtiene el tipo de cambio que representa cómo se desencadena el evento modificado. Vea Excel.DataChangeType para más información.

changeType: Excel.DataChangeType | "Unknown" | "RangeEdited" | "RowInserted" | "RowDeleted" | "ColumnInserted" | "ColumnDeleted" | "CellInserted" | "CellDeleted";

Valor de propiedad

Excel.DataChangeType | "Unknown" | "RangeEdited" | "RowInserted" | "RowDeleted" | "ColumnInserted" | "ColumnDeleted" | "CellInserted" | "CellDeleted"

Comentarios

[ Conjunto de API: ExcelApi 1.7 ]

details

Representa la información sobre los detalles del cambio. Esta propiedad se puede recuperar cuando se desencadena el evento modificado en una sola celda. Si el evento modificado se desencadena en varias celdas, esta propiedad no se puede recuperar.

details: Excel.ChangedEventDetail;

Valor de propiedad

Excel.ChangedEventDetail

Comentarios

[ Conjunto de API: ExcelApi 1.9 ]

Ejemplos

// This function would be used as an event handler for the Worksheet.onChanged event.
async function onWorksheetChanged(eventArgs) {
    await Excel.run(async (context) => {
        const details = eventArgs.details;
        const address = eventArgs.address;

        // Print the before and after types and values to the console.
        console.log(`Change at ${address}: was ${details.valueBefore}(${details.valueTypeBefore}),`
            + ` now is ${details.valueAfter}(${details.valueTypeAfter})`);
        await context.sync();
    });
}

source

Obtiene el origen del evento. Vea Excel.EventSource para más información.

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

Valor de propiedad

Excel.EventSource | "Local" | "Remote"

Comentarios

[ Conjunto de API: ExcelApi 1.7 ]

type

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

type: "WorksheetChanged";

Valor de propiedad

"WorksheetChanged"

Comentarios

[ Conjunto de API: ExcelApi 1.7 ]

worksheetId

Obtiene el identificador de la hoja de cálculo en la que cambiaron los datos.

worksheetId: string;

Valor de propiedad

string

Comentarios

[ Conjunto de API: ExcelApi 1.7 ]

Detalles del método

getRange(ctx)

Obtiene el intervalo que representa el área que ha cambiado en una hoja de cálculo específica.

[ Conjunto de API: ExcelApi 1.8 ]

getRange(ctx: Excel.RequestContext): Excel.Range;

Parámetros

ctx

Excel.RequestContext

Devoluciones

Excel.Range

getRangeOrNullObject(ctx)

Obtiene el intervalo que representa el área que ha cambiado en una hoja de cálculo específica. Puede devolver un objeto null.

[ Conjunto de API: ExcelApi 1.8 ]

getRangeOrNullObject(ctx: Excel.RequestContext): Excel.Range;

Parámetros

ctx

Excel.RequestContext

Devoluciones

Excel.Range