Excel.TableChangedEventArgs interface
Enthält Informationen über die Tabelle, die das geänderte Ereignis ausgelöst hat.
Hinweise
Verwendet von
Eigenschaften
| address | Ruft die Adresse ab, die den geänderten Bereich der Tabelle auf einem bestimmten Arbeitsblatt darstellt. |
| change |
Ruft den Änderungstyp ab, der angibt, wie das geänderte Ereignis ausgelöst wird. Weitere Informationen findest du hier |
| details | 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. |
| source | Ruft die Quelle des Ereignisses ab. Weitere Informationen findest du hier |
| table |
Ruft die ID der Tabelle ab, in der die Daten geändert wurden. |
| type | Ruft den Typ des Ereignisses ab. Weitere Informationen findest du hier |
| worksheet |
Ruft die ID des Arbeitsblatts ab, in dem die Daten geändert wurden. |
Methoden
| get |
Ruft den Bereich ab, der den geänderten Bereich einer Tabelle auf einem bestimmten Arbeitsblatt darstellt. |
| get |
Ruft den Bereich ab, der den geänderten Bereich einer Tabelle auf einem bestimmten Arbeitsblatt darstellt. Möglicherweise wird ein NULL-Objekt zurückgegeben. |
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
changeType
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
Excel.DataChangeType | "Unknown" | "RangeEdited" | "RowInserted" | "RowDeleted" | "ColumnInserted" | "ColumnDeleted" | "CellInserted" | "CellDeleted"
Hinweise
details
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
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) {
// 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);
}
});
}
source
Ruft die Quelle des Ereignisses ab. Weitere Informationen findest du hier Excel.EventSource .
source: Excel.EventSource | "Local" | "Remote";Eigenschaftswert
Excel.EventSource | "Local" | "Remote"
Hinweise
tableId
Ruft die ID der Tabelle ab, in der die Daten geändert wurden.
tableId: string;Eigenschaftswert
string
Hinweise
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 findest du hier Excel.EventType .
type: "TableChanged";Eigenschaftswert
"TableChanged"
Hinweise
worksheetId
Ruft die ID des Arbeitsblatts ab, in dem die Daten geändert wurden.
worksheetId: string;Eigenschaftswert
string
Hinweise
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);
});
}
Details zur Methode
getRange(ctx)
Ruft den Bereich ab, der den geänderten Bereich einer Tabelle auf einem bestimmten Arbeitsblatt darstellt.
getRange(ctx: Excel.RequestContext): Excel.Range;Parameter
Gibt zurück
getRangeOrNullObject(ctx)
Ruft den Bereich ab, der den geänderten Bereich einer Tabelle auf einem bestimmten Arbeitsblatt darstellt. Möglicherweise wird ein NULL-Objekt zurückgegeben.
getRangeOrNullObject(ctx: Excel.RequestContext): Excel.Range;