Excel.ChangedEventDetail interface

Пакет:
excel

Предоставляет сведения о деталях WorksheetChangedEvent или TableChangedEvent.

Комментарии

Набор API: ExcelApi 1.9

Используется

Примеры

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

Свойства

valueAfter

Представляет значение после изменения. Возвращаемые данные могут быть строкой, числом или логическим значением. Ячейки, содержащие ошибку, вернут строку ошибки.
valueAsJsonAfter

Представляет тип значения после изменения. В отличие от valueAfter, valueAsJsonAfter может представлять все значения ячеек, такие как форматированное число, веб-изображение и типы данных сущности.
valueAsJsonBefore

Представляет тип значения до изменения. В отличие от valueBefore, valueAsJsonBefore может представлять все значения ячеек, такие как форматированное число, веб-изображение и типы данных сущности.
valueBefore

Представляет значение до изменения. Возвращаемые данные могут быть строкой, числом или логическим значением. Ячейки, содержащие ошибку, вернут строку ошибки.
valueTypeAfter

Представляет тип значения после изменения.
valueTypeBefore

Представляет тип значения до изменения.

Сведения о свойстве

valueAfter

Представляет значение после изменения. Возвращаемые данные могут быть строкой, числом или логическим значением. Ячейки, содержащие ошибку, вернут строку ошибки.

valueAfter: any;

Значение свойства

any

Комментарии

Набор API: ExcelApi 1.9

valueAsJsonAfter

Представляет тип значения после изменения. В отличие от valueAfter, valueAsJsonAfter может представлять все значения ячеек, такие как форматированное число, веб-изображение и типы данных сущности.

valueAsJsonAfter: CellValue;

Значение свойства

Excel.CellValue

Комментарии

Набор API: ExcelApi 1.16

valueAsJsonBefore

Представляет тип значения до изменения. В отличие от valueBefore, valueAsJsonBefore может представлять все значения ячеек, такие как форматированное число, веб-изображение и типы данных сущности.

valueAsJsonBefore: CellValue;

Значение свойства

Excel.CellValue

Комментарии

Набор API: ExcelApi 1.16

valueBefore

Представляет значение до изменения. Возвращаемые данные могут быть строкой, числом или логическим значением. Ячейки, содержащие ошибку, вернут строку ошибки.

valueBefore: any;

Значение свойства

any

Комментарии

Набор API: ExcelApi 1.9

valueTypeAfter

Представляет тип значения после изменения.

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

Значение свойства

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

Комментарии

Набор API: ExcelApi 1.9

valueTypeBefore

Представляет тип значения до изменения.

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

Значение свойства

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

Комментарии

Набор API: ExcelApi 1.9