Neuerungen in Excel JavaScript API 1.12

ExcelApi 1.12 hat die Unterstützung für Formeln in Bereichen verbessert, indem APIs zum Nachverfolgen dynamischer Arrays und zum Suchen der direkten Vorgänger einer Formel hinzugefügt wurden. Außerdem wurde die API-Steuerung von PivotTable-Filtern hinzugefügt. Verbesserungen wurden auch in den Featurebereichen "Kommentar", "Kultureinstellungen" und "Benutzerdefinierte Eigenschaften" vorgenommen.

Funktionsbereich Beschreibung Relevante Objekte
Kommentieren von Ereignissen Fügt der Kommentarsammlung Ereignisse für hinzufügen, ändern und löschen hinzu. CommentCollection
Einstellungen der Datums- und Uhrzeitkultur Ermöglicht Zugriff auf zusätzliche kulturelle Einstellungen rund um die Datums- und Uhrzeitformatierung. CultureInfo, NumberFormatInfoAnwendung
Direkte Präzedenzfälle Gibt Bereiche zurück, die zum Auswerten der Formel einer Zelle verwendet werden. Range
Pivot-Filter Wendet wertgesteuerte Filter auf die Felder einer PivotTable an. PivotFeld, PivotFilter
Range spilling Ermöglicht Add-Ins, Bereiche zu finden, die dynamischen Arrayergebnissen zugeordnet sind. Range
Benutzerdefinierte Eigenschaften auf Arbeitsblattebene Ermöglicht die Beschränkung benutzerdefinierter Eigenschaften auf Arbeitsblattebene und nicht auf Arbeitsmappenebene, sondern auch auf Arbeitsblattebene. WorksheetCustomProperty, WorksheetCustomPropertyCollection

API-Liste

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

Klasse Felder Beschreibung
ChartAxisTitle textOrientation Gibt den Winkel an, in dem der Text für den Titel der Diagrammachse ausgerichtet ist.
ChartSeries getDimensionValues(dimension: Excel.ChartSeriesDimension) Ruft die Werte aus einer einzelnen Dimension der Diagrammreihe ab.
Kommentar contentType Ruft den Inhaltstyp des Kommentars ab.
CommentAddedEventArgs commentDetails Ruft das CommentDetail Array ab, das die Kommentar-ID und die IDs der zugehörigen Antworten enthält.
source Gibt die Quelle des Ereignisses an.
type Ruft den Typ des Ereignisses ab.
worksheetId Ruft die ID des Arbeitsblatts ab, in dem das Ereignis aufgetreten ist.
CommentChangedEventArgs changeType Ruft den Änderungstyp ab, der angibt, wie das geänderte Ereignis ausgelöst wird.
commentDetails Rufen Sie das CommentDetail Array ab, das die Kommentar-ID und die IDs der zugehörigen Antworten enthält.
source Gibt die Quelle des Ereignisses an.
type Ruft den Typ des Ereignisses ab.
worksheetId Ruft die ID des Arbeitsblatts ab, in dem das Ereignis aufgetreten ist.
CommentCollection onAdded Tritt auf, wenn die Kommentare hinzugefügt werden.
onChanged Tritt beim Ändern von Kommentaren oder Antworten in einer Kommentarsammlung auf, auch wenn Antworten gelöscht werden.
onDeleted Tritt auf, wenn Kommentare in der Kommentarsammlung gelöscht werden.
CommentDeletedEventArgs commentDetails Ruft das CommentDetail Array ab, das die Kommentar-ID und die IDs der zugehörigen Antworten enthält.
source Gibt die Quelle des Ereignisses an.
type Ruft den Typ des Ereignisses ab.
worksheetId Ruft die ID des Arbeitsblatts ab, in dem das Ereignis aufgetreten ist.
CommentDetail commentId Stellt die ID des Kommentars dar.
replyIds Stellt die IDs der verwandten Antworten dar, die zum Kommentar gehören.
CommentReply contentType Der Inhaltstyp der Antwort.
CultureInfo datetimeFormat Definiert das kulturell angemessene Format für die Anzeige von Datum und Uhrzeit.
DatetimeFormatInfo dateSeparator Ruft die Zeichenfolge ab, die als Datumstrennzeichen verwendet wird.
longDatePattern Ruft die Formatzeichenfolge für einen langen Datumswert ab.
longTimePattern Ruft die Formatzeichenfolge für einen langen Zeitwert ab.
shortDatePattern Ruft die Formatzeichenfolge für einen kurzen Datumswert ab.
timeSeparator Ruft die Zeichenfolge ab, die als Zeittrennzeichen verwendet wird.
PivotDateFilter Komparator Der Komparator ist der statische Wert, mit dem andere Werte verglichen werden.
Bedingung Gibt die Bedingung für den Filter an, die die erforderlichen Filterkriterien definiert.
Exklusiv Wenn trueder Filter ausschließt, werden Elemente ausgeschlossen , die die Kriterien erfüllen.
lowerBound Die untere Grenze des Bereichs für die between Filterbedingung.
upperBound Die Obergrenze des Bereichs für die between Filterbedingung.
ganze Tage Gibt equalsfür , before, afterund between Filterbedingungen an, ob Vergleiche als ganze Tage durchgeführt werden sollen.
PivotField applyFilter(filter: Excel.PivotFilters) Legt mindestens einen der aktuellen PivotFilters des Felds fest und wendet sie auf das Feld an.
clearAllFilters() Löscht alle Kriterien aus allen Filtern des Felds.
clearFilter(filterType: Excel.PivotFilterType) Löscht alle vorhandenen Kriterien aus dem Filter des Felds des angegebenen Typs (falls einer derzeit angewendet wird).
getFilters() Ruft alle Filter ab, die derzeit auf dem Feld angewendet werden.
isFiltered(filterType?: Excel.PivotFilterType) Überprüft, ob angewendete Filter auf dem Feld vorhanden sind.
PivotFilters dateFilter Der aktuell angewendete Datumsfilter des PivotFields.
labelFilter Der aktuell angewendete Beschriftungsfilter des PivotField.
manualFilter Der derzeit vom PivotField angewendete manuelle Filter.
valueFilter Der aktuell angewendete Wertfilter des PivotField.
PivotLabelFilter Komparator Der Komparator ist der statische Wert, mit dem andere Werte verglichen werden.
Bedingung Gibt die Bedingung für den Filter an, die die erforderlichen Filterkriterien definiert.
Exklusiv Wenn trueder Filter ausschließt, werden Elemente ausgeschlossen , die die Kriterien erfüllen.
lowerBound Die untere Grenze des Bereichs für die between Filterbedingung.
substring Die Teilzeichenfolge, endsWithdie für die beginsWith, und contains Filterbedingungen verwendet wird.
upperBound Die Obergrenze des Bereichs für die between Filterbedingung.
PivotManualFilter selectedItems Eine Liste ausgewählter Elemente, die manuell gefiltert werden sollen.
PivotTable allowMultipleFiltersPerField Gibt an, ob die PivotTable die Anwendung mehrerer PivotFilters auf ein bestimmtes PivotField in der Tabelle zulässt.
PivotTableScopedCollection getCount() Ruft die Anzahl der PivotTables in der Auflistung ab.
getFirst() Ruft die erste PivotTable in der Auflistung ab.
getItem(key: string) Ruft eine PivotTable anhand des Namens ab.
GetItemOrNullObject(name: string) Ruft eine PivotTable anhand des Namens ab.
items Ruft die geladenen untergeordneten Elemente in dieser Sammlung ab.
PivotValueFilter Komparator Der Komparator ist der statische Wert, mit dem andere Werte verglichen werden.
Bedingung Gibt die Bedingung für den Filter an, die die erforderlichen Filterkriterien definiert.
Exklusiv Wenn trueder Filter ausschließt, werden Elemente ausgeschlossen , die die Kriterien erfüllen.
lowerBound Die untere Grenze des Bereichs für die between Filterbedingung.
selectionType Gibt an, ob der Filter für die oberen/unteren N Elemente, die oberen/unteren N Prozent oder die obere/untere N-Summe gilt.
Schwellenwert Der Schwellenwert "N" Anzahl der Elemente, Prozentsätze oder Summen, die für eine obere/untere Filterbedingung gefiltert werden sollen.
upperBound Die Obergrenze des Bereichs für die between Filterbedingung.
value Der Name des ausgewählten "Werts" im Feld, nach dem gefiltert werden soll.
Range getDirectPrecedents() Gibt ein WorkbookRangeAreas Objekt zurück, das den Bereich darstellt, der alle unmittelbar vorhergehenden Zellen eines angegebenen Bereichs im selben Arbeitsblatt oder in mehreren Arbeitsblättern enthält.
getPivotTables(fullyContained?: boolescher Wert) Ruft eine bereichsbezogene Auflistung von PivotTables ab, die sich mit dem Bereich überschneiden.
getSpillParent() Ruft das Bereichsobjekt ab, das die Ankerzelle für eine Zelle enthält, in die ein Überlauf erfolgen kann.
getSpillParentOrNullObject() Ruft das Bereichsobjekt ab, das die Ankerzelle enthält, in die die Zelle überläuft.
getSpillingToRange() Ruft beim Aufruf für eine Ankerzelle das Bereichsobjekt ab, das den Überlaufbereich enthält.
getSpillingToRangeOrNullObject() Ruft beim Aufruf für eine Ankerzelle das Bereichsobjekt ab, das den Überlaufbereich enthält.
hasSpill Stellt dar, ob alle Zellen einen Überlaufrahmen aufweisen.
numberFormatCategories Stellt die Kategorie des Zahlenformats für jede Zelle dar.
savedAsArray Gibt an, ob alle Zellen als Arrayformel gespeichert werden sollen.
RangeAreasCollection getCount() Ruft die Anzahl der RangeAreas Objekte in dieser Sammlung ab.
getItemAt(index: number) Gibt das Objekt basierend auf der Position in der RangeAreas Sammlung zurück.
items Ruft die geladenen untergeordneten Elemente in dieser Sammlung ab.
WorkbookRangeAreas addresses Gibt ein Array von Adressen im A1-Stil zurück.
areas Gibt das RangeAreasCollection Objekt zurück.
getRangeAreasBySheet(key: string) Gibt das Objekt anhand der RangeAreas Arbeitsblatt-ID oder des Namens in der Sammlung zurück.
getRangeAreasOrNullObjectBySheet(key: string) Gibt das Objekt basierend auf dem RangeAreas Arbeitsblattnamen oder der ID in der Sammlung zurück.
Bereiche Gibt Bereiche zurück, die dieses Objekt in einem RangeCollection Objekt enthalten.
Arbeitsblatt customProperties Ruft eine Auflistung benutzerdefinierter Eigenschaften auf Arbeitsblattebene ab.
WorksheetCustomProperty delete() Löscht die benutzerdefinierte Eigenschaft.
key Ruft den Schlüssel der benutzerdefinierten Eigenschaft ab.
value Gibt den Wert der benutzerdefinierten Eigenschaft an.
WorksheetCustomPropertyCollection add(key: string, value: string) Fügt eine neue benutzerdefinierte Eigenschaft hinzu, die dem bereitgestellten Schlüssel zugeordnet ist.
getCount() Ruft die Anzahl der benutzerdefinierten Eigenschaften auf diesem Arbeitsblatt ab.
getItem(key: string) Ruft ein Objekt für benutzerdefinierte Eigenschaften über seinen Schlüssel ab, bei dem Groß-/Kleinschreibung nicht beachtet wird.
getItemOrNullObject(key: string) Ruft ein Objekt für benutzerdefinierte Eigenschaften über seinen Schlüssel ab, bei dem Groß-/Kleinschreibung nicht beachtet wird.
items Ruft die geladenen untergeordneten Elemente in dieser Sammlung ab.

Siehe auch