Excel.WorksheetChangedEventArgs interface
Enthält Informationen über das Arbeitsblatt, das das geänderte Ereignis ausgelöst hat.
Hinweise
Verwendet von
Eigenschaften
| address | Ruft die Bereichsadresse ab, die den geänderten Bereich eines bestimmten Arbeitsblatts darstellt. |
| change |
Ruft den Änderungstyp ab, der angibt, wie das geänderte Ereignis ausgelöst wird. Weitere Informationen findest du hier |
| details | Stellt die Informationen zum Änderungsdetail dar. 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 |
| 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 eines bestimmten Arbeitsblatts darstellt. |
| get |
Ruft den Bereich ab, der den geänderten Bereich eines bestimmten Arbeitsblatts darstellt. Möglicherweise wird ein NULL-Objekt zurückgegeben. |
Details zur Eigenschaft
address
Ruft die Bereichsadresse ab, die den geänderten Bereich eines bestimmten Arbeitsblatts 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
Stellt die Informationen zum Änderungsdetail dar. 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
// This function would be used as an event handler for the Worksheet.onChanged event.
async function onWorksheetChanged(eventArgs) {
await Excel.run(async (context) => {
const details = eventArgs.details;
const address = eventArgs.address;
// Print the before and after types and values to the console.
console.log(`Change at ${address}: was ${details.valueBefore}(${details.valueTypeBefore}),`
+ ` now is ${details.valueAfter}(${details.valueTypeAfter})`);
await context.sync();
});
}
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
type
Ruft den Typ des Ereignisses ab. Weitere Informationen findest du hier Excel.EventType .
type: "WorksheetChanged";
Eigenschaftswert
"WorksheetChanged"
Hinweise
worksheetId
Ruft die ID des Arbeitsblatts ab, in dem die Daten geändert wurden.
worksheetId: string;
Eigenschaftswert
string
Hinweise
Details zur Methode
getRange(ctx)
Ruft den Bereich ab, der den geänderten Bereich eines bestimmten Arbeitsblatts darstellt.
getRange(ctx: Excel.RequestContext): Excel.Range;
Parameter
Gibt zurück
getRangeOrNullObject(ctx)
Ruft den Bereich ab, der den geänderten Bereich eines bestimmten Arbeitsblatts darstellt. Möglicherweise wird ein NULL-Objekt zurückgegeben.
getRangeOrNullObject(ctx: Excel.RequestContext): Excel.Range;