Excel.WorksheetChangedEventArgs interface
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. |
| change |
Obtiene el tipo de cambio que representa cómo se desencadena el evento modificado. Vea |
| 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 |
| type | Obtiene el tipo del evento. Vea |
| worksheet |
Obtiene el identificador de la hoja de cálculo en la que cambiaron los datos. |
Métodos
| get |
Obtiene el intervalo que representa el área que ha cambiado en una hoja de cálculo específica. |
| get |
Obtiene el intervalo que representa el área que ha cambiado en una hoja de cálculo específica. Puede devolver un objeto null. |
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
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
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
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
type
Obtiene el tipo del evento. Vea Excel.EventType para más información.
type: "WorksheetChanged";Valor de propiedad
"WorksheetChanged"
Comentarios
worksheetId
Obtiene el identificador de la hoja de cálculo en la que cambiaron los datos.
worksheetId: string;Valor de propiedad
string
Comentarios
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
Devoluciones
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;