Freigeben über

Rückgängigmachen der Unterstützung mit der Excel-JavaScript-API

Excel-Add-Ins unterstützen das Rückgängig-Verhalten. Dadurch werden sowohl Aktionen, die von Excel-JavaScript-APIs ausgeführt werden, als auch Aktionen beibehalten, die vom Benutzer in Excel ausgeführt werden. Diese Aktionen werden im Rückgängig-Stapel für einen einzelnen Benutzer gespeichert, sodass der Benutzer seine Aktionen bei Bedarf durchlaufen kann.

Gruppierung rückgängig

Die Excel-JavaScript-API unterstützt auch das Rückgängigmachen von Gruppierung. Auf diese Weise können Sie mehrere API-Aufrufe in einer einzelnen nicht rückgängig machenden Aktion für Ihren Add-In-Benutzer gruppieren. Wenn Ihr Add-In beispielsweise mehrere unterschiedliche Aktualisierungen auf mehreren Arbeitsblättern als Reaktion auf einen einzelnen Benutzerbefehl vornehmen muss, können Sie alle diese Updates in einer einzigen Gruppe umschließen. Dies erfolgt mit der -Eigenschaft, die mergeUndoGroup für die Excel.run Funktion bereitgestellt wird.

Wenn eine API innerhalb der Gruppe keine Rückgängig-Unterstützung bietet, wird der UndoNotSupported Fehler ausgelöst, um Sie darüber zu informieren, dass der Vorgang nicht gruppiert werden kann. Ihr Add-In sollte diesen Fehler ordnungsgemäß behandeln und dem Benutzer eine angemessene Meldung präsentieren.

Im folgenden Codebeispiel wird gezeigt, wie mehrere Aktionen mit mergeUndoGroup auf festgelegt truewerden.

Wichtig

Stellen Sie sicher, dass alle gruppierten API-Aufrufe rückgängig machen unterstützen, um Fehler zu vermeiden. Weitere Informationen finden Sie unter Nicht unterstützte APIs .

await Excel.run({ mergeUndoGroup: true }, async (context) => { 
    const sheet = context.workbook.worksheets.getActiveWorksheet(); 
    let range = sheet.getRange("A1"); 
    range.values = [["123"]]; 
    
    await context.sync(); 
    
    range = sheet.getRange("B2"); 
    range.values = [["456"]];

    await context.sync(); 
});

Nicht unterstützte APIs

Die meisten Excel-JavaScript-APIs unterstützen Rückgängig-Aktionen. In der folgenden Tabelle finden Sie jedoch eine Liste der APIs, die das Rückgängig-Verhalten nicht unterstützen.

Tipp

Wenn Sie eine nicht unterstützte API in Ihrem Add-In aufrufen, wird der Rückgängig-Stapel des Benutzers ab diesem API-Aufruf gelöscht, und ein Benutzer kann Aktionen nach diesem Zeitpunkt nicht rückgängigmachen.

API Unterstützt in Excel im Web Unterstützt in Excel unter Windows und Excel unter Mac Hinweise
AllowEditRange.address Nein Nein Keine
AllowEditRange.delete Nein Nein Keine
AllowEditRange.pauseProtection Nein Nein Keine
AllowEditRange.setPassword Nein Nein Keine
AllowEditRange.title Nein Nein Keine
AllowEditRangeCollection.add Nein Nein Keine
AllowEditRangeCollection.pauseProtection Nein Nein Keine
Chart.categoryLabelLevel Nein Nein Keine
Chart.seriesNameLevel Nein Nein Keine
ChartPivotOptions.showAxisFieldButtons Nein Ja Keine
ChartPivotOptions.showLegendFieldButtons Nein Ja Keine
ChartPivotOptions.showReportFilterFieldButtons Nein Ja Keine
ChartPivotOptions.showValueFieldButtons Nein Ja Keine
ChartTrendlineLabel.formula Nein Ja Keine
DataConnectionCollection.refreshAll Nein Nein Keine
DocumentProperties.author​ Nein Ja Keine
DocumentProperties.category Nein Ja Keine
DocumentProperties.comments Nein Ja Keine
DocumentProperties.company Nein Ja Keine
DocumentProperties.keywords Nein Ja Keine
DocumentProperties.manager Nein Ja Keine
DocumentProperties.revisionNumber Nein Ja Keine
DocumentProperties.subject Nein Ja Keine
DocumentProperties.title Nein Ja Keine
LinkedWorkbook.refresh Nein Nein Keine
LinkedWorkbookCollection.refreshAll Nein Nein Keine
NamedItem.comment Nein Ja Keine
PivotTableStyle.delete Nein Ja Die API unterstützt das gemeinsame Erstellen von Rückgängigmachen in Excel unter Windows und Mac nicht .
PivotTableStyle.duplicate Nein Ja Keine
PivotTableStyle.name Nein Ja Keine
PivotTableStyleCollection.add Nein Ja Die API unterstützt das gemeinsame Erstellen von Rückgängigmachen in Excel unter Windows und Mac nicht .
PivotTableStyleCollection.setDefault Nein Ja Die API unterstützt das gemeinsame Erstellen von Rückgängigmachen in Excel unter Windows und Mac nicht .
Query.delete Nein Ja Die API unterstützt das Rückgängigmachen in Excel unter Windows und Mac, aber nicht das Wiederholen.
Query.refresh Nein Ja Die API unterstützt Das Rückgängigmachen von Excel unter Windows und Mac, aber das Wiederholen wird nicht unterstützt.
QueryCollection.refreshAll Nein Ja Die API unterstützt Das Rückgängigmachen von Excel unter Windows und Mac, aber das Wiederholen wird nicht unterstützt.
Slicer.name Nein Ja Keine
Slicer.nameInFormula Nein Ja Keine
SlicerStyle.delete Nein Ja Die API unterstützt das gemeinsame Erstellen von Rückgängigmachen in Excel unter Windows und Mac nicht .
SlicerStyle.duplicate Nein Ja Keine
SlicerStyle.name Nein Ja Keine
SlicerStyleCollection.add Nein Ja Die API unterstützt das gemeinsame Erstellen von Rückgängigmachen in Excel unter Windows und Mac nicht .
SlicerStyleCollection.setDefault Nein Ja Die API unterstützt das gemeinsame Erstellen von Rückgängigmachen in Excel unter Windows und Mac nicht .
Style.addIndent Nein Ja Keine
Style.autoIndent Nein Ja Keine
Style.formulaHidden Nein Ja Keine
Style.horizontalAlignment Nein Ja Keine
Style.includeAlignment Nein Ja Keine
Style.includeBorder Nein Ja Keine
Style.includeFont Nein Ja Keine
Style.includeNumber Nein Ja Keine
Style.includePatterns Nein Ja Keine
Style.includeProtection Nein Ja Keine
Style.indentLevel Nein Ja Keine
Style.locked Nein Ja Keine
Style.numberFormat Nein Ja Keine
Style.numberFormatLocal Nein Ja Keine
Style.orientation Nein Ja Keine
Style.readingOrder Nein Ja Keine
Style.shrinkToFit Nein Ja Keine
Style.textOrientation Nein Ja Keine
Style.verticalAlignment Nein Ja Keine
Style.wrapText Nein Ja Keine
TableStyle.delete Nein Ja Die API unterstützt das gemeinsame Erstellen von Rückgängigmachen in Excel unter Windows und Mac nicht .
TableStyle.duplicate Nein Ja Keine
TableStyle.name Nein Ja Keine
TableStyleCollection.add Nein Ja Die API unterstützt das gemeinsame Erstellen von Rückgängigmachen in Excel unter Windows und Mac nicht .
TableStyleCollection.setDefault Nein Ja Die API unterstützt das gemeinsame Erstellen von Rückgängigmachen in Excel unter Windows und Mac nicht .
TimelineStyle.delete Nein Ja Die API unterstützt das gemeinsame Erstellen von Rückgängigmachen in Excel unter Windows und Mac nicht .
TimelineStyle.duplicate Nein Ja Keine
TimelineStyle.name Nein Ja Keine
TimelineStyleCollection.add Nein Ja Die API unterstützt das gemeinsame Erstellen von Rückgängigmachen in Excel unter Windows und Mac nicht .
TimelineStyleCollection.setDefault Nein Ja Die API unterstützt das gemeinsame Erstellen von Rückgängigmachen in Excel unter Windows und Mac nicht .
Workbook.close Nein Nein Keine
Workbook.insertWorksheetsFromBase64 Nein Nein Keine
Workbook.save Nein Nein Keine
WorkbookProtection.protect Nein Nein Keine
WorkbookProtection.unprotect Nein Nein Keine
Worksheet.copy Nein Nein Keine
Worksheet.delete Nein Nein Keine
Worksheet.name Ja Nein Keine
Worksheet.standardWidth Nein Ja Keine
Worksheet.position Ja Nein Keine
Worksheet.visibility​ Ja Nein Keine
WorksheetCollection.addFromBase64 Nein Nein Keine
WorksheetProtection.pauseProtection Nein Nein Keine
WorksheetProtection.protect Nein Nein Keine
WorksheetProtection.resumeProtection Nein Nein Keine
WorksheetProtection.setPassword Nein Nein Keine
WorksheetProtection.unprotect Nein Nein Keine
WorksheetProtection.updateOptions Nein Nein Keine

Siehe auch

  • Last updated on