Excel.TableChangedEventArgs interface

Obtient l’adresse qui représente la zone modifiée d’un tableau figurant dans une feuille de calcul spécifique.

address: string;

Valeur de propriété

Remarques

Jeu d’API : ExcelApi 1.7

Obtient le type de modification qui représente la façon dont l’événement modifié est déclenché. Pour Excel.DataChangeType plus de détails.

changeType: Excel.DataChangeType | "Unknown" | "RangeEdited" | "RowInserted" | "RowDeleted" | "ColumnInserted" | "ColumnDeleted" | "CellInserted" | "CellDeleted";

Valeur de propriété

Remarques

Jeu d’API : ExcelApi 1.7

Obtient les informations sur les détails de la modification. Cette propriété peut être récupérée lorsque l’événement modifié est déclenché sur une seule cellule. Si l’événement modifié est déclenché sur plusieurs cellules, cette propriété ne peut pas être récupérée.

details: Excel.ChangedEventDetail;

Valeur de propriété

Remarques

Jeu d’API : ExcelApi 1.9

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) {
    await Excel.run(async (context) => {
        const details = eventArgs.details;
        const address = eventArgs.address;

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

Obtient la source de l’événement. Pour Excel.EventSource plus de détails.

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

Valeur de propriété

Remarques

Jeu d’API : ExcelApi 1.7

Obtient l’ID de la table dans laquelle les données ont changé.

tableId: string;

Valeur de propriété

Remarques

Jeu d’API : ExcelApi 1.7

Exemples

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

async function onChange(event) {
    await Excel.run(async (context) => {
        let table = context.workbook.tables.getItem(event.tableId);
        let worksheet = context.workbook.worksheets.getItem(event.worksheetId);
        worksheet.load("name");

        await context.sync();

        console.log("Handler for table collection onChanged event has been triggered. Data changed address: " + event.address);
        console.log("Table Id : " + event.tableId);
        console.log("Worksheet Id : " + worksheet.name);
    });
}

Obtient le type de l’événement. Pour Excel.EventType plus de détails.

type: "TableChanged";

Valeur de propriété

Remarques

Jeu d’API : ExcelApi 1.7

Obtient l’ID de la feuille de calcul dans laquelle les données ont changé.

worksheetId: string;

Valeur de propriété

Remarques

Jeu d’API : ExcelApi 1.7

Exemples

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

async function onChange(event) {
    await Excel.run(async (context) => {
        let table = context.workbook.tables.getItem(event.tableId);
        let worksheet = context.workbook.worksheets.getItem(event.worksheetId);
        worksheet.load("name");

        await context.sync();

        console.log("Handler for table collection onChanged event has been triggered. Data changed address: " + event.address);
        console.log("Table Id : " + event.tableId);
        console.log("Worksheet Id : " + worksheet.name);
    });
}

Obtient la plage qui représente la zone modifiée d’un tableau dans une feuille de calcul spécifique.

Jeu d’API : ExcelApi 1.8

getRange(ctx: Excel.RequestContext): Excel.Range;

Paramètres

Retours

Obtient la plage qui représente la zone modifiée d’un tableau dans une feuille de calcul spécifique. Il peut renvoyer un objet null.

Jeu d’API : ExcelApi 1.8

getRangeOrNullObject(ctx: Excel.RequestContext): Excel.Range;

Paramètres

Retours