Teilen über

Anforderungssatz 1.1 für die Excel-JavaScript-API nur für Desktops

Der ExcelApiDesktop Anforderungssatz ist ein spezieller Anforderungssatz, der Features enthält, die nur in Excel für Windows und Excel für Mac verfügbar sind. APIs in diesem Anforderungssatz gelten als Produktions-APIs für die Excel-Anwendung unter Windows und Mac. Sie folgen den Microsoft 365-Entwicklersupportrichtlinien. ExcelApiDesktop APIs gelten als "Vorschau"-APIs für andere Plattformen (z. B. Web und iPad) und werden möglicherweise von keiner dieser Plattformen unterstützt.

Wenn APIs im Anforderungssatz ExcelApiDesktop plattformübergreifend unterstützt werden, werden sie dem nächsten freigegebenen Anforderungssatz (ExcelApi 1.[NEXT]) hinzugefügt. Sobald dieser neue Anforderungssatz öffentlich ist, werden diese APIs auch weiterhin in diesem Anforderungssatz ExcelApiDesktop markiert. Weitere Informationen zu plattformspezifischen Anforderungen im Allgemeinen finden Sie unter Grundlegendes zu plattformspezifischen Anforderungssätzen.

Wichtig

ExcelApiDesktop 1.1 ist ein Nur-Desktop-Anforderungssatz. Es handelt sich um eine Obermenge von ExcelApi 1.20.

Da die ExcelApiDesktop 1.1 APIs nur von Excel unter Windows und Mac unterstützt werden, sollte Ihr Add-In überprüfen, ob der Anforderungssatz unterstützt wird, bevor diese APIs aufgerufen werden. Dadurch wird jeglicher Versuch vermieden, nur Desktop-APIs auf einer nicht unterstützten Plattform zu verwenden.

if (Office.context.requirements.isSetSupported("ExcelApiDesktop", "1.1")) {
   // Any API exclusive to this ExcelApiDesktop requirement set.
}

Sobald sich die API in einem plattformübergreifenden Anforderungssatz befindet, sollten Sie die isSetSupported Überprüfung entfernen oder bearbeiten. Dadurch wird das Feature Ihres Add-Ins auf anderen Plattformen aktiviert. Stellen Sie sicher, dass Sie das Feature auf diesen Plattformen testen, wenn Sie diese Änderung vornehmen.

Wichtig

Ihr Manifest kann nicht als Aktivierungsanforderung angeben ExcelApiDesktop 1.1 . Es ist kein gültiger Wert, der im Set-Element verwendet werden kann.

API-Liste

In der folgenden Tabelle sind die Excel-JavaScript-APIs aufgeführt, die derzeit im Anforderungssatz ExcelApiDesktop 1.1 enthalten sind. Eine vollständige Liste aller Excel-JavaScript-APIs (einschließlich ExcelApiDesktop 1.1 APIs und zuvor veröffentlichter APIs) finden Sie unter Alle Excel-JavaScript-APIs.

Klasse Felder Beschreibung
Anwendung activeWindow Gibt ein window -Objekt zurück, das das aktive Fenster (das Fenster oben) darstellt.
checkSpelling(word: string, options?: Excel.CheckSpellingOptions) Prüft die Rechtschreibung eines einzelnen Worts.
enterEditingMode() Wechselt in den Bearbeitungsmodus für den ausgewählten Bereich im aktiven Arbeitsblatt.
union(firstRange: Range | RangeAreas, secondRange: Range | RangeAreas, ... additionalRanges: (Range | RangeAreas)[]) Gibt ein RangeAreas -Objekt zurück, das die Vereinigung von zwei oder mehr Range -Objekten oder RangeAreas -Objekten darstellt.
Fenster Gibt alle geöffneten Excel-Fenster zurück.
CheckSpellingOptions customDictionary Optional.
ignoreUppercase Optional.
HeaderFooter centerFooterPicture Ruft ein HeaderFooterPicture -Objekt ab, das das Bild für den mittleren Abschnitt der Fußzeile darstellt.
centerHeaderPicture Ruft ein HeaderFooterPicture -Objekt ab, das das Bild für den mittleren Abschnitt der Kopfzeile darstellt.
leftFooterPicture Ruft ein HeaderFooterPicture -Objekt ab, das das Bild für den linken Abschnitt der Fußzeile darstellt.
leftHeaderPicture Ruft ein HeaderFooterPicture -Objekt ab, das das Bild für den linken Abschnitt der Kopfzeile darstellt.
rightFooterPicture Ruft ein HeaderFooterPicture -Objekt ab, das das Bild für den rechten Abschnitt der Fußzeile darstellt.
rightHeaderPicture Ruft ein HeaderFooterPicture -Objekt ab, das das Bild für den rechten Abschnitt der Kopfzeile darstellt.
HeaderFooterPicture Helligkeit Gibt die Helligkeit des Bilds an.
Farbtyp Gibt den Typ der Farbtransformation des Bilds an.
Kontrast Gibt den Kontrast des Bilds an.
cropBottom Gibt die Anzahl der Punkte an, die am unteren Rand des Bilds zugeschnitten werden.
cropLeft Gibt die Anzahl der Punkte an, die von der linken Seite des Bilds abgeschnitten werden.
cropRight Gibt die Anzahl der Punkte an, die von der rechten Seite des Bilds abgeschnitten werden.
cropTop Gibt die Anzahl der Punkte an, die am oberen Rand des Bilds zugeschnitten werden.
Dateiname Gibt die URL (im Intranet oder im Web) oder den Pfad (lokal oder netzwerk) zu dem Speicherort an, an dem das Quellobjekt gespeichert ist.
height Gibt die Höhe des Bilds in Punkt an.
lockAspectRatio Gibt einen Wert an, der angibt, ob das Bild seine ursprünglichen Proportionen beibehält, wenn die Größe geändert wird.
width Gibt die Breite des Bilds in Punkt an.
Image Helligkeit Gibt die Helligkeit des Bilds an.
Farbtyp Gibt den Typ der Farbtransformation an, die auf das Bild angewendet wird.
Kontrast Gibt den Kontrast des Bilds an.
cropBottom Gibt die Anzahl der Punkte an, die am unteren Rand des Bilds zugeschnitten werden.
cropLeft Gibt die Anzahl der Punkte an, die von der linken Seite des Bilds abgeschnitten werden.
cropRight Gibt die Anzahl der Punkte an, die von der rechten Seite des Bilds abgeschnitten werden.
cropTop Gibt die Anzahl der Punkte an, die am oberen Rand des Bilds zugeschnitten werden.
incrementBrightness(increment: number) Erhöht die Helligkeit des Bilds um einen angegebenen Betrag.
incrementContrast(increment: number) Erhöht den Kontrast des Bilds um einen angegebenen Betrag.
PageLayout alignMarginsHeaderFooter Gibt an, ob Excel die Kopf- und Fußzeile an den Rändern ausrichtet, die in den Seiteneinrichtungsoptionen festgelegt sind.
printQuality Gibt ein Array mit zwei Elementen an, das sowohl horizontale als auch vertikale Druckqualitätswerte enthält.
Fensterausschnitt Index Gibt den Index des Bereichs zurück.
PaneCollection getCount() Gibt die Anzahl der Bereiche in der Auflistung zurück.
getItemAt(index: number) Ruft den Bereich in der Auflistung nach Index ab.
items Ruft die geladenen untergeordneten Elemente in dieser Sammlung ab.
Range checkSpelling(options?: Excel.CheckSpellingOptions) Überprüft die Rechtschreibung von Wörtern in diesem Bereich.
formulaArray Gibt die Arrayformel eines Bereichs an.
showDependents(remove?: boolean) Zeichnet Spurpfeile zu den direkten Nachfolgern des Bereichs.
showPrecedents(remove?: boolean) Zeichnet Spurpfeile zu den direkten Vorgängerzellen des Bereichs.
Window activate() Aktiviert das Fenster.
activateNext() Aktiviert das nächste Fenster.
activatePrevious() Aktiviert das vorherige Fenster.
activeCell Ruft die aktive Zelle im Fenster ab.
activePane Ruft den aktiven Bereich im Fenster ab.
activeWorksheet Ruft das aktive Arbeitsblatt im Fenster ab.
autoFilterDateGroupingEnabled Gibt an, ob die AutoFilter-Datumsgruppierung im Fenster aktiviert ist.
close() Schließt das Fenster.
enableResize Gibt an, ob die Größenänderung für das Fenster aktiviert ist.
freezePanes Gibt an, ob Bereiche im Fenster fixiert sind.
height Gibt die Höhe des Fensters an.
Index Ruft den Index des Fensters ab.
isVisible Gibt an, ob das Fenster sichtbar ist.
largeScroll(Down: number, Up: number, ToRight: number, ToLeft: number) Führt einen Bildlauf im Fenster um mehrere Seiten durch.
left Gibt den Abstand in Punkt vom linken Rand des Computerbildschirms zum linken Rand des Fensters an.
name Gibt den Namen des Fensters an.
newWindow() Öffnet ein neues Excel-Fenster.
Scheiben Ruft eine Auflistung von Bereichen ab, die dem Fenster zugeordnet sind.
pointsToScreenPixelsX(Points: number) Konvertiert horizontale Punkte in Bildschirmpixel.
pointsToScreenPixelsY(Points: number) Konvertiert vertikale Punkte in Bildschirmpixel.
scrollColumn Gibt die Bildlaufspalte des Fensters an.
scrollIntoView(Left: number, Top: number, Width: number, Height: number, Start?: boolean) Führt einen Bildlauf im Fenster durch, um den angegebenen Bereich anzuzeigen.
scrollRow Gibt die Bildlaufzeile des Fensters an.
scrollWorkbookTabs(Sheets?: number, Position?: Excel.ScrollWorkbookTabPosition) Führt einen Bildlauf auf den Arbeitsmappenregistern durch.
showFormulas Gibt an, ob Formeln im Fenster angezeigt werden.
showGridlines Gibt an, ob Gitternetzlinien im Fenster angezeigt werden.
showHeadings Gibt an, ob Überschriften im Fenster angezeigt werden.
showHorizontalScrollBar Gibt an, ob die horizontale Bildlaufleiste im Fenster angezeigt wird.
showOutline Gibt an, ob die Gliederung im Fenster angezeigt wird.
showRightToLeft Ruft den Rechts-nach-links-Layoutwert des Fensters ab.
showRuler Gibt an, ob das Lineal im Fenster angezeigt wird.
showVerticalScrollBar Gibt an, ob die vertikale Bildlaufleiste im Fenster angezeigt wird.
showWhitespace Gibt an, ob Leerzeichen im Fenster angezeigt werden.
showWorkbookTabs Gibt an, ob Arbeitsmappenregister im Fenster angezeigt werden.
showZeros Gibt an, ob Nullen im Fenster angezeigt werden.
smallScroll(Down: number, Up: number, ToRight: number, ToLeft: number) Führt einen Bildlauf im Fenster um eine Reihe von Zeilen oder Spalten durch.
trennen Gibt den geteilten Zustand des Fensters an.
splitColumn Gibt die geteilte Spalte des Fensters an.
splitHorizontal Gibt die horizontale Aufteilung des Fensters an.
splitRow Gibt die geteilte Zeile des Fensters an.
splitVertical Gibt die vertikale Aufteilung des Fensters an.
tabRatio Gibt das Tabstoppverhältnis des Fensters an.
top Gibt den Abstand in Punkt vom oberen Rand des Fensters zum oberen Rand des verwendbaren Bereichs an (unterhalb der Menüs, aller oben angedockten Symbolleisten und der Bearbeitungsleiste).
type Gibt den Typ des Fensters an.
usableHeight Ruft die verwendbare Höhe des Fensters ab.
usableWidth Ruft die verwendbare Breite des Fensters ab.
view Gibt die Ansicht des Fensters an.
visibleRange Ruft den sichtbaren Bereich des Fensters ab.
width Gibt die Anzeigebreite des Fensters an.
windowNumber Ruft die Fensternummer ab.
windowState Gibt den Fensterstatus an.
zoom Gibt einen ganzzahligen Wert an, der die Anzeigegröße des Fensters darstellt.
WindowCollection breakSideBySide() Unterbricht die nebeneinander angeordnete Ansicht von Fenstern.
compareCurrentSideBySideWith(windowName: string) Vergleicht das aktuelle Fenster nebeneinander mit dem angegebenen Fenster.
getCount() Ruft die Anzahl der Fenster in der Auflistung ab.
getItemAt(index: number) Ruft das Fenster in der Auflistung nach Index ab.
items Ruft die geladenen untergeordneten Elemente in dieser Sammlung ab.
resetPositionsSideBySide() Setzt die Positionen von Fenstern in nebeneinander angeordneter Ansicht zurück.
Workbook focus() Legt den Fokus auf die Arbeitsmappe fest.
Arbeitsblatt checkSpelling(options?: Excel.CheckSpellingOptions) Überprüft die Rechtschreibung von Wörtern in diesem Arbeitsblatt.
clearArrows() Löscht die Pfeile der Ablaufverfolgung aus dem Arbeitsblatt.
evaluate(name: string) Gibt das Auswertungsergebnis einer Formelzeichenfolge zurück.

Siehe auch

  • Last updated on