Excel.ChangedEventDetail interface

Package:
excel

Fournit des informations sur les détails d’un ou TableChangedEventd’un WorksheetChangedEvent .

Remarques

Jeu d’API : ExcelApi 1.9

Utilisateur

Exemples

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

Propriétés

valueAfter

Représente la valeur après la modification. Les données renvoyées peuvent être une chaîne, un nombre ou une valeur booléenne. Les cellules contenant une erreur renvoie la chaîne d’erreur.
valueBefore

Représente la valeur avant la modification. Les données renvoyées peuvent être une chaîne, un nombre ou une valeur booléenne. Les cellules contenant une erreur renvoie la chaîne d’erreur.
valueTypeAfter

Représente le type de valeur après la modification.
valueTypeBefore

Représente le type de valeur avant la modification.

Détails de la propriété

valueAfter

Représente la valeur après la modification. Les données renvoyées peuvent être une chaîne, un nombre ou une valeur booléenne. Les cellules contenant une erreur renvoie la chaîne d’erreur.

valueAfter: any;

Valeur de propriété

any

Remarques

Jeu d’API : ExcelApi 1.9

valueBefore

Représente la valeur avant la modification. Les données renvoyées peuvent être une chaîne, un nombre ou une valeur booléenne. Les cellules contenant une erreur renvoie la chaîne d’erreur.

valueBefore: any;

Valeur de propriété

any

Remarques

Jeu d’API : ExcelApi 1.9

valueTypeAfter

Représente le type de valeur après la modification.

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

Valeur de propriété

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

Remarques

Jeu d’API : ExcelApi 1.9

valueTypeBefore

Représente le type de valeur avant la modification.

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

Valeur de propriété

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

Remarques

Jeu d’API : ExcelApi 1.9