Freigeben über

Excel.TableChangedEventArgs interface

  • Referenz
Paket:
excel

Stellt Informationen zu der Tabelle bereit, die das geänderte Ereignis ausgelöst hat.

Hinweise

[ API-Satz: ExcelApi 1.7 ]

Eigenschaften

address

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

Ruft den Änderungstyp ab, der angibt, wie das geänderte Ereignis ausgelöst wird. Weitere Informationen finden Sie unter Excel.DataChangeType .
source

Ruft die Quelle des Ereignisses ab. Weitere Informationen finden Sie unter Excel.EventSource .
tableId

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

Ruft den Typ des Ereignisses ab. Weitere Informationen finden Sie unter Excel.EventType .
worksheetId

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

Details zur Eigenschaft

address

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

address: string;

Eigenschaftswert

string

Hinweise

[ API-Satz: ExcelApi 1.7 ]

changeType

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

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

Hinweise

[ API-Satz: ExcelApi 1.7 ]

source

Ruft die Quelle des Ereignisses ab. Weitere Informationen finden Sie unter Excel.EventSource .

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

Eigenschaftswert

Excel.EventSource | "Local" | "Remote"

Hinweise

[ API-Satz: ExcelApi 1.7 ]

tableId

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

tableId: string;

Eigenschaftswert

string

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

type

Ruft den Typ des Ereignisses ab. Weitere Informationen finden Sie unter Excel.EventType .

type: "TableChanged";

Eigenschaftswert

"TableChanged"

Hinweise

[ API-Satz: ExcelApi 1.7 ]

worksheetId

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

worksheetId: string;

Eigenschaftswert

string

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