Excel.WorksheetChangedEventArgs interface
Fornece informações sobre a folha de cálculo que levantou o evento alterado.
Comentários
[ Conjunto de API: ExcelApi 1.7 ]
Propriedades
| address | Obtém o endereço do intervalo que representa a área alterada de uma planilha específica. |
| change |
Obtém o tipo de alteração que representa a forma como o evento alterado é acionado. Veja |
| details | Representa as informações sobre o detalhe da alteração. Esta propriedade pode ser obtida quando o evento alterado é acionado numa única célula. Se o evento alterado for acionado em múltiplas células, esta propriedade não pode ser obtida. |
| source | Obtém a origem do evento. Veja |
| type | Obtém o tipo do evento. Veja |
| worksheet |
Obtém o ID da folha de cálculo na qual os dados foram alterados. |
Métodos
| get |
Obtém o intervalo que representa a área alterada de uma planilha específica. |
| get |
Obtém o intervalo que representa a área alterada de uma planilha específica. Pode retornar o objeto null. |
Detalhes da propriedade
address
Obtém o endereço do intervalo que representa a área alterada de uma planilha específica.
address: string;Valor da propriedade
string
Comentários
changeType
Obtém o tipo de alteração que representa a forma como o evento alterado é acionado. Veja Excel.DataChangeType para obter detalhes.
changeType: Excel.DataChangeType | "Unknown" | "RangeEdited" | "RowInserted" | "RowDeleted" | "ColumnInserted" | "ColumnDeleted" | "CellInserted" | "CellDeleted";Valor da propriedade
Excel.DataChangeType | "Unknown" | "RangeEdited" | "RowInserted" | "RowDeleted" | "ColumnInserted" | "ColumnDeleted" | "CellInserted" | "CellDeleted"
Comentários
details
Representa as informações sobre o detalhe da alteração. Esta propriedade pode ser obtida quando o evento alterado é acionado numa única célula. Se o evento alterado for acionado em múltiplas células, esta propriedade não pode ser obtida.
details: Excel.ChangedEventDetail;Valor da propriedade
Comentários
[ Conjunto de API: ExcelApi 1.9 ]
Exemplos
// 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
Obtém a origem do evento. Veja Excel.EventSource para obter detalhes.
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: "WorksheetChanged";Valor da propriedade
"WorksheetChanged"
Comentários
worksheetId
Obtém o ID da folha de cálculo na qual os dados foram alterados.
worksheetId: string;Valor da propriedade
string
Comentários
Detalhes do método
getRange(ctx)
Obtém o intervalo que representa a área alterada de uma planilha específica.
[ Conjunto de API: ExcelApi 1.8 ]
getRange(ctx: Excel.RequestContext): Excel.Range;Parâmetros
Retornos
getRangeOrNullObject(ctx)
Obtém o intervalo que representa a área alterada de uma planilha específica. Pode retornar o objeto null.
[ Conjunto de API: ExcelApi 1.8 ]
getRangeOrNullObject(ctx: Excel.RequestContext): Excel.Range;