Excel.TableChangedEventArgs interface

Ruft die Adresse ab, die den geänderten Bereich der Tabelle auf einem bestimmten Arbeitsblatt darstellt.

address: string;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.7

Ruft den Änderungstyp ab, der angibt, wie das geänderte Ereignis ausgelöst wird. Weitere Informationen findest du hier Excel.DataChangeType .

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

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.7

Ruft die Informationen zu den Änderungsdetails ab. Diese Eigenschaft kann abgerufen werden, wenn das geänderte Ereignis für eine einzelne Zelle ausgelöst wird. Wenn das geänderte Ereignis für mehrere Zellen ausgelöst wird, kann diese Eigenschaft nicht abgerufen werden.

details: Excel.ChangedEventDetail;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.9

Beispiele

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

Ruft die Quelle des Ereignisses ab. Weitere Informationen findest du hier Excel.EventSource .

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

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.7

Ruft die ID der Tabelle ab, in der die Daten geändert wurden.

tableId: string;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.7

Beispiele

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

Ruft den Typ des Ereignisses ab. Weitere Informationen findest du hier Excel.EventType .

type: "TableChanged";

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.7

Ruft die ID des Arbeitsblatts ab, in dem die Daten geändert wurden.

worksheetId: string;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.7

Beispiele

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

Ruft den Bereich ab, der den geänderten Bereich einer Tabelle auf einem bestimmten Arbeitsblatt darstellt.

API-Satz: ExcelApi 1.8

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

Parameter

Gibt zurück

Ruft den Bereich ab, der den geänderten Bereich einer Tabelle auf einem bestimmten Arbeitsblatt darstellt. Möglicherweise wird ein NULL-Objekt zurückgegeben.

API-Satz: ExcelApi 1.8

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

Parameter

Gibt zurück