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 では、書式設定された数値、Web 画像、エンティティ データ型など、すべてのセル値を表すことができます。
valueAsJsonBefore

変更前の値の型を表します。 valueBefore とは異なり、valueAsJsonBefore では、書式設定された数値、Web 画像、エンティティ データ型など、すべてのセル値を表すことができます。
valueBefore

変更前の値を表します。 返されるデータは、文字列、数値、またはブール値を指定できます。 エラーが含まれているセルは、エラー文字列を返します。
valueTypeAfter

変更後の値の型を表します。
valueTypeBefore

変更前の値の型を表します。

プロパティの詳細

valueAfter

変更後の値を表します。 返されるデータは、文字列、数値、またはブール値を指定できます。 エラーが含まれているセルは、エラー文字列を返します。

valueAfter: any;

プロパティ値

any

注釈

API セット: ExcelApi 1.9

valueAsJsonAfter

変更後の値の型を表します。 valueAfter とは異なり、valueAsJsonAfter では、書式設定された数値、Web 画像、エンティティ データ型など、すべてのセル値を表すことができます。

valueAsJsonAfter: CellValue;

プロパティ値

Excel.CellValue

注釈

API セット: ExcelApi 1.16

valueAsJsonBefore

変更前の値の型を表します。 valueBefore とは異なり、valueAsJsonBefore では、書式設定された数値、Web 画像、エンティティ データ型など、すべてのセル値を表すことができます。

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