Excel.WorksheetChangedEventArgs interface

Paket:

excel

Stellt Informationen zu dem Arbeitsblatt bereit, das das geänderte Ereignis ausgelöst hat.

Hinweise

[ API-Satz: ExcelApi 1.7 ]

Eigenschaften

address	Ruft die Bereichsadresse ab, die den geänderten Bereich eines bestimmten Arbeitsblatts darstellt.
changeType	Ruft den Änderungstyp ab, der angibt, wie das geänderte Ereignis ausgelöst wird. Weitere Informationen finden Sie unter Excel.DataChangeType .
details	Stellt die Informationen zum Änderungsdetails dar. 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.
source	Ruft die Quelle des Ereignisses ab. Weitere Informationen finden Sie unter Excel.EventSource .
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.

Methoden

getRange(ctx)	Ruft den Bereich ab, der den geänderten Bereich eines bestimmten Arbeitsblatts darstellt. [ API-Satz: ExcelApi 1.8 ]
getRangeOrNullObject(ctx)	Ruft den Bereich ab, der den geänderten Bereich eines bestimmten Arbeitsblatts darstellt. Möglicherweise wird ein NULL-Objekt zurückgegeben. [ API-Satz: ExcelApi 1.8 ]

Details zur Eigenschaft

address

Ruft die Bereichsadresse ab, die den geänderten Bereich eines bestimmten Arbeitsblatts 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 ]

details

Stellt die Informationen zum Änderungsdetails dar. 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

Excel.ChangedEventDetail

Hinweise

[ API-Satz: ExcelApi 1.9 ]

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

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

Eigenschaftswert

Excel.EventSource | "Local" | "Remote"

Hinweise

[ API-Satz: ExcelApi 1.7 ]

type

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

type: "WorksheetChanged";

Eigenschaftswert

"WorksheetChanged"

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 ]

Details zur Methode

getRange(ctx)

Ruft den Bereich ab, der den geänderten Bereich eines bestimmten Arbeitsblatts darstellt.

[ API-Satz: ExcelApi 1.8 ]

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

Parameter

ctx

Excel.RequestContext

Gibt zurück

Excel.Range

getRangeOrNullObject(ctx)

Ruft den Bereich ab, der den geänderten Bereich eines bestimmten Arbeitsblatts darstellt. Möglicherweise wird ein NULL-Objekt zurückgegeben.

[ API-Satz: ExcelApi 1.8 ]

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

Parameter

ctx

Excel.RequestContext

Gibt zurück

Excel.Range