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 finden Sie unter Excel.DataChangeType .

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

Eigenschaftswert

Hinweise

[ API-Satz: ExcelApi 1.7 ]

Ruft die Informationen zum Änderungsdetails ab. Diese Eigenschaft kann abgerufen werden, wenn das geänderte Ereignis in einer einzelnen 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 finden Sie unter 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 finden Sie unter 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