Excel.WorksheetChangedEventArgs interface

Obtém o endereço do intervalo que representa a área alterada de uma planilha específica.

address: string;

Valor da propriedade

Comentários

[ Conjunto de API: ExcelApi 1.7 ]

Representa uma alteração na direção em que as células numa folha de cálculo se deslocam quando uma célula ou células são eliminadas ou inseridas. Isto inclui os dois cenários seguintes. 1. A direção (por exemplo, para baixo ou para a direita) que as células existentes irão mudar quando uma nova célula ou células são inseridas numa folha de cálculo. 2. A direção (como para cima ou para a esquerda) que as células restantes irão mudar quando uma célula ou células são eliminadas de uma folha de cálculo.

changeDirectionState: Excel.ChangeDirectionState;

Valor da propriedade

Comentários

[ Conjunto de API: ExcelApi 1.14 ]

Exemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/30-events/events-worksheet.yaml

async function onChange(event: Excel.WorksheetChangedEventArgs) {
    // This function is an event handler that returns the address, trigger source, 
    // and insert or delete shift directions of the change.
    await Excel.run(async (context) => {
        // Return the address where change occurred.
        console.log(`Handler for worksheet onChanged event has been triggered.`);
        console.log(`    Data changed address: ` + event.address);

        // Return the source of the event that triggered the change.
        console.log(`    Data change trigger source: ` + event.triggerSource);

        // Note：insertShiftDirection and deleteShiftDirection are exclusive and both enums can't have a value at the same time. 
        // If one has a value, then the other will return undefined.

        // If the insert shift direction is defined, return it.
        if (event.changeDirectionState.insertShiftDirection) {
            console.log(`    Cells inserted shift direction: ` + event.changeDirectionState.insertShiftDirection);
        }

        // If the delete shift direction is defined, return it.
        if (event.changeDirectionState.deleteShiftDirection) {
            console.log(`    Cells deleted shift direction: ` + event.changeDirectionState.deleteShiftDirection);
        }
    });
}  

...

// This function deletes data from a range and sets the delete shift direction to "up".
await Excel.run(async (context) => {
    const sheet = context.workbook.worksheets.getItem("Sample");
    const range = sheet.getRange("A5:F5");
    range.delete(Excel.DeleteShiftDirection.up);
});

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

Comentários

[ Conjunto de API: ExcelApi 1.7 ]

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();
    });
}

Obtém a origem do evento. Veja Excel.EventSource para obter detalhes.

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

Valor da propriedade

Comentários

[ Conjunto de API: ExcelApi 1.7 ]

Representa a origem do acionador do evento. Por exemplo, identifica se este suplemento local aciona o evento.

triggerSource: Excel.EventTriggerSource | "Unknown" | "ThisLocalAddin";

Valor da propriedade

Comentários

[ Conjunto de API: ExcelApi 1.14 ]

Exemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/30-events/events-worksheet.yaml

async function onChange(event: Excel.WorksheetChangedEventArgs) {
    // This function is an event handler that returns the address, trigger source, 
    // and insert or delete shift directions of the change.
    await Excel.run(async (context) => {
        // Return the address where change occurred.
        console.log(`Handler for worksheet onChanged event has been triggered.`);
        console.log(`    Data changed address: ` + event.address);

        // Return the source of the event that triggered the change.
        console.log(`    Data change trigger source: ` + event.triggerSource);

        // Note：insertShiftDirection and deleteShiftDirection are exclusive and both enums can't have a value at the same time. 
        // If one has a value, then the other will return undefined.

        // If the insert shift direction is defined, return it.
        if (event.changeDirectionState.insertShiftDirection) {
            console.log(`    Cells inserted shift direction: ` + event.changeDirectionState.insertShiftDirection);
        }

        // If the delete shift direction is defined, return it.
        if (event.changeDirectionState.deleteShiftDirection) {
            console.log(`    Cells deleted shift direction: ` + event.changeDirectionState.deleteShiftDirection);
        }
    });
}  

Obtém o tipo do evento. Veja Excel.EventType para obter detalhes.

type: "WorksheetChanged";

Valor da propriedade

Comentários

[ Conjunto de API: ExcelApi 1.7 ]

Obtém o ID da folha de cálculo na qual os dados foram alterados.

worksheetId: string;

Valor da propriedade

Comentários

[ Conjunto de API: ExcelApi 1.7 ]

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

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;

Parâmetros

Retornos