Excel.ChangedEventDetail interface

Fornece informações sobre os detalhes de um WorksheetChangedEvent ou TableChangedEvent.

Comentários

Conjunto de APIs: ExcelApi 1.9

Usada por

Exemplos

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

async function onTableChanged(eventArgs: Excel.TableChangedEventArgs) {
    // Inspect the values and basic types of an edited table cell, and identify errors.
    await Excel.run(async (context) => {
        const details: Excel.ChangedEventDetail = eventArgs.details;
        const address = eventArgs.address;
        if (!details) {
            console.log("Edit one table cell at a time to inspect its value and type.");
            return;
        }

        console.log(`Change at ${address}: was ${details.valueBefore}(${details.valueTypeBefore}),`
          + ` now is ${details.valueAfter}(${details.valueTypeAfter})`);

        const errorType: Excel.RangeValueType = Excel.RangeValueType.error;
        if (details.valueTypeAfter === errorType) {
            console.log("The updated cell contains an error:", details.valueAfter);
        }
    });
}

Propriedades

valueAfter

Representa o valor após a alteração. Os dados retornados podem ser uma cadeia de caracteres, um número ou um booleano. Células que contêm um erro retornarão a cadeia de caracteres de erro.

valueBefore

Representa o valor antes da alteração. Os dados retornados podem ser uma cadeia de caracteres, um número ou um booleano. Células que contêm um erro retornarão a cadeia de caracteres de erro.

valueTypeAfter

Representa o tipo de valor após a alteração.

valueTypeBefore

Representa o tipo de valor antes da alteração.

Detalhes da propriedade

valueAfter

Representa o valor após a alteração. Os dados retornados podem ser uma cadeia de caracteres, um número ou um booleano. Células que contêm um erro retornarão a cadeia de caracteres de erro.

valueAfter: any;

Valor da propriedade

any

Comentários

Conjunto de APIs: ExcelApi 1.9

valueBefore

Representa o valor antes da alteração. Os dados retornados podem ser uma cadeia de caracteres, um número ou um booleano. Células que contêm um erro retornarão a cadeia de caracteres de erro.

valueBefore: any;

Valor da propriedade

any

Comentários

Conjunto de APIs: ExcelApi 1.9

valueTypeAfter

Representa o tipo de valor após a alteração.

valueTypeAfter: Excel.RangeValueType | "Unknown" | "Empty" | "String" | "Integer" | "Double" | "Boolean" | "Error" | "RichValue";

Valor da propriedade

Excel.RangeValueType | "Unknown" | "Empty" | "String" | "Integer" | "Double" | "Boolean" | "Error" | "RichValue"

Comentários

Conjunto de APIs: ExcelApi 1.9

valueTypeBefore

Representa o tipo de valor antes da alteração.

valueTypeBefore: Excel.RangeValueType | "Unknown" | "Empty" | "String" | "Integer" | "Double" | "Boolean" | "Error" | "RichValue";

Valor da propriedade

Excel.RangeValueType | "Unknown" | "Empty" | "String" | "Integer" | "Double" | "Boolean" | "Error" | "RichValue"

Comentários

Conjunto de APIs: ExcelApi 1.9