Neuigkeiten in der Excel-JavaScript-API 1.4

  • Artikel

Im Folgenden werden die neuen Elemente der Excel-JavaScript-APIs in Anforderungssatz 1.4 aufgeführt.

Benanntes Element wurde hinzugefügt und neue Eigenschaften

Neue Eigenschaften:

  • comment
  • scope - Arbeitsblatt- oder Arbeitsmappenbezogene Elemente.
  • worksheet – Gibt das Arbeitsblatt zurück, auf das das benannte Element ausgerichtet ist.

Neue Methoden:

  • add(name: string, reference: Range or string, comment: string) – Fügt der Auflistung des angegebenen Bereichs einen neuen Namen hinzu.
  • addFormulaLocal(name: string, formula: string, comment: string) – Fügt der Auflistung des angegebenen Bereichs unter Verwendung des Gebietsschemas des Benutzers für die Formel einen neuen Namen hinzu.

Einstellungs-API im Excel-Namespace

Das Setting-Objekt stellt ein Schlüssel/Wert-Paar einer dauerhaften Einstellung für das Dokument dar. Die Funktionalität von Excel.Setting entspricht Office.Settings, verwendet aber die Syntax der Batch-API und nicht das Rückrufmodell der allgemeinen API.

APIs umfassen getItem() , um den Einstellungseintrag über den Schlüssel abzurufen und add() das angegebene Schlüssel-Wert-Einstellungspaar zur Arbeitsmappe hinzuzufügen.

Sonstige

  • Legen Sie den Namen der Tabellenspalte fest.
  • Fügen Sie am Ende der Tabelle eine Tabellenspalte hinzu.
  • Fügen Sie einer Tabelle gleichzeitig mehrere Zeilen hinzu.
  • range.getColumnsAfter(count: number) und range.getColumnsBefore(count: number) zum Abrufen einer bestimmten Anzahl von Spalten rechts/links vom aktuellen Bereichsobjekt.
  • Die *OrNullObject-Methoden und -Eigenschaften: Diese Funktion ermöglicht das Abrufen eines Objekts mithilfe eines Schlüssels. Wenn das Objekt nicht vorhanden ist, ist die -Eigenschaft des isNullObject zurückgegebenen Objekts true. Auf diese Weise können Entwickler überprüfen, ob ein Objekt vorhanden ist, ohne es über die Ausnahmebehandlung behandeln zu müssen. Eine *OrNullObject -Methode ist für die meisten Auflistungsobjekte verfügbar.
worksheet.getItemOrNullObject("itemName")

API-Liste

In der folgenden Tabelle sind die APIs im Excel-JavaScript-API-Anforderungssatz 1.4 aufgeführt. Informationen zum Anzeigen der API-Referenzdokumentation für alle APIs, die vom Excel-JavaScript-API-Anforderungssatz 1.4 oder früher unterstützt werden, finden Sie unter Excel-APIs in Anforderungssatz 1.4 oder früher.

Klasse Felder Beschreibung
BindingCollection getCount() Ruft die Anzahl der Bindungen in der Sammlung ab.
getItemOrNullObject(id: string) Ruft ein binding-Objekt anhand seiner ID ab.
ChartCollection getCount() Gibt die Anzahl der Diagramme im Arbeitsblatt zurück.
GetItemOrNullObject(name: string) Ruft ein Diagramm über seinen Namen ab.
ChartPointsCollection getCount() Gibt die Anzahl der Diagrammpunkten in der Reihe zurück.
ChartSeriesCollection getCount() Gibt die Anzahl der Datenreihen in der Sammlung zurück.
NamedItem comment Gibt den Kommentar an, der diesem Namen zugeordnet ist.
delete() Löscht den angegebenen Namen.
getRangeOrNullObject() Ruft das Bereichsobjekt ab, das mit dem Namen verknüpft ist.
scope Gibt an, ob der Name auf die Arbeitsmappe oder ein bestimmtes Arbeitsblatt festgelegt ist.
worksheet Gibt das Arbeitsblatt zurück, auf dessen Bereich das benannte Element beschränkt ist.
worksheetOrNullObject Gibt das Arbeitsblatt zurück, für das das benannte Element gültig ist.
NamedItemCollection add(name: string, reference: Range | string, comment?: string) Fügt einen neuen Namen zur Auflistung des angegebenen Bereichs hinzu.
addFormulaLocal(name: string, formula: string, comment?: string) Fügt einen neuen Namen zu der Auflistung des angegebenen Bereichs unter Verwendung des Gebietsschemas des Benutzers für die Formel hinzu.
getCount() Ruft die Anzahl von benannten Elementen in der Auflistung ab.
GetItemOrNullObject(name: string) Ruft ein NamedItem -Objekt unter Verwendung seines Namens ab.
PivotTableCollection getCount() Ruft die Anzahl von PivotTables in der Auflistung ab.
GetItemOrNullObject(name: string) Ruft eine PivotTable anhand des Namens ab.
Range getIntersectionOrNullObject(anotherRange: Range | string) Ruft das Bereichsobjekt ab, das die rechteckige Schnittmenge der angegebenen Bereiche darstellt.
getUsedRangeOrNullObject(valuesOnly?: boolean) Gibt den verwendeten Bereich des angegebenen Bereichsobjekts zurück.
RangeViewCollection getCount() Ruft die Anzahl der RangeView -Objekte in der Auflistung ab.
Einstellung delete() Löscht die Einstellung.
key Der Schlüssel, der die ID der Einstellung darstellt.
value Stellt den Wert dar, der für diese Einstellung gespeichert ist.
SettingCollection add(key: string, value: string | number | boolean | Datum | any[] | any) Legt die angegebene Einstellung fest oder fügt sie zur Arbeitsmappe hinzu.
getCount() Ruft die Anzahl der Einstellungen in der Auflistung ab.
getItem(key: string) Ruft einen Einstellungseintrag über den Schlüssel ab.
getItemOrNullObject(key: string) Ruft einen Einstellungseintrag über den Schlüssel ab.
items Ruft die geladenen untergeordneten Elemente in dieser Sammlung ab.
onSettingsChanged Tritt auf, wenn die Einstellungen im Dokument geändert werden.
SettingsChangedEventArgs Einstellungen Ruft das -Objekt ab Setting , das die Bindung darstellt, die das Einstellungsänderungsereignis ausgelöst hat.
TableCollection getCount() Ruft die Anzahl von Tabellen in der Auflistung ab.
getItemOrNullObject(key: string) Ruft eine Tabelle anhand des Namens oder der ID ab.
TableColumnCollection getCount() Ruft die Anzahl der Spalten in der Tabelle ab.
getItemOrNullObject(key: number | string) Ruft ein Spaltenobjekt nach Name oder ID ab.
TableRowCollection getCount() Ruft die Anzahl der Zeilen in der Tabelle ab.
Workbook Einstellungen Stellt eine Auflistung von Einstellungen dar, die der Arbeitsmappe zugeordnet sind.
Arbeitsblatt getUsedRangeOrNullObject(valuesOnly?: boolean) Der verwendete Bereich ist der kleinste Bereich, der mindestens eine der Zellen umfasst, die einen Wert enthalten oder denen eine Formatierung zugewiesen wurde.
Namen Auflistung von Namen im Bereich des aktuellen Arbeitsblatts.
WorksheetCollection getCount(visibleOnly?: boolean) Ruft die Anzahl von Arbeitsblättern in der Auflistung ab.
getItemOrNullObject(key: string) Ruft das Arbeitsblattobjekt mithilfe des Namens oder der ID ab.

Siehe auch