- 09/03/2020
- 4 minut číst
-
- o
- R
- l
- m
-
+4
Tento článek popisuje, jak použít Excel JavaScript API sestavení add-in pro Excel 2016 nebo později. Zavádí základní pojmy, které jsou zásadní pro používání API, a poskytuje pokyny pro provádění zvláštních úkolů, jako je čtení nebo psaní velkého rozsahu, aktualizuje všechny buňky v dosahu, a další.
Důležité
Viz Použití pro specifické aplikace API, model, dozvědět se o asynchronní povaze Excel Api a jak pracují se sešitem.
kancelář.JS API pro Excel
doplněk Excel interaguje s objekty v Excelu pomocí Office JavaScript API, které zahrnuje dva objektové modely JavaScriptu:
-
Excel JavaScript API: Představil s Office 2016, Excel JavaScript API poskytuje silně typované objekty, které můžete použít pro přístup k listy, rozsahy, tabulky, grafy a další.
-
Společné Api: Představil Office 2013, Společné API může být použit pro přístup k funkcím, jako je uživatelské ROZHRANÍ, dialogy a nastavení klienta, které jsou společné napříč různými typy Kancelářských aplikací.
i Když budete pravděpodobně používat Excel JavaScript API rozvíjet většinu funkcí v add-inů, které cílové aplikaci Excel 2016 nebo později, budete také používat objekty ve Společné API. Například:
- kontext: objekt
Context
představuje běhové prostředí doplňku a poskytuje přístup ke klíčovým objektům API. Skládá se z podrobností konfigurace sešitu, jako jecontentLanguage
aofficeTheme
, a také poskytuje informace o runtime prostředí doplňku, jako jehost
aplatform
. Navíc poskytuje metodurequirements.isSetSupported()
, kterou můžete použít ke kontrole, zda je zadaná sada požadavků podporována aplikací Excel, kde je doplněk spuštěn. - dokument: objekt
Document
poskytuje metodugetFileAsync()
, kterou můžete použít ke stažení souboru aplikace Excel, kde je spuštěn doplněk.
následující obrázek ukazuje, kdy můžete použít Excel JavaScript API nebo společné API.
objektový model specifický pro Excel
Chcete-li porozumět API aplikace Excel, musíte pochopit, jak jsou součásti sešitu vzájemně propojeny.
- sešit obsahuje jeden nebo více listů.
- List obsahuje sbírky těchto datových objektů, které jsou přítomny v jednotlivých list, a umožňuje přístup do buňky přes Řadu objektů.
- rozsah představuje skupinu sousedících buněk.
- rozsahy se používají k vytváření a umisťování tabulek, grafů, tvarů a dalších vizualizačních nebo organizačních objektů dat.
- sešity obsahují sbírky některých z těchto datových objektů (například tabulky) pro celý sešit.
Rozsahy
rozsah je skupina sousedících buněk v sešitu. B3 pro jednu buňku ve sloupci B a řádku 3 nebo C2: F4 pro buňky ze sloupců C až F a řádků 2 až 4) k definování rozsahů.
rozsahy mají tři základní vlastnosti: values
, formulas
a format
. Tyto vlastnosti získají nebo nastaví hodnoty buněk, vzorce, které mají být vyhodnoceny, a vizuální formátování buněk.
rozsah vzorek
následující ukázka ukazuje, jak vytvořit prodejní záznamy. Tato funkce používá objekty Range
k nastavení hodnot, vzorců a formátů.
Tento příklad vytvoří následující data v aktuálním listu:
Pro více informací, viz Práce s rozsahy pomocí aplikace Excel JavaScript API.
grafy, tabulky a další datové objekty
API JavaScriptu aplikace Excel mohou vytvářet a manipulovat s datovými strukturami a vizualizacemi v aplikaci Excel. Tabulky a grafy jsou dva z běžně používaných objektů, ale API podporují kontingenční tabulky, tvary, obrázky a další.
vytvoření tabulky
vytvoření tabulek pomocí rozsahů vyplněných daty. Formátování a ovládací prvky tabulky (například filtry) se automaticky použijí na rozsah.
následující vzorek vytvoří tabulku pomocí rozsahů z předchozího vzorku.
Pomocí tento ukázkový kód na listu s předchozí data vytváří následující tabulce:
Pro více informací, viz Práce s tabulkami pomocí aplikace Excel JavaScript API.
vytvoření grafu
vytvoření grafů pro vizualizaci dat v rozsahu. API podporují desítky odrůd grafů, z nichž každá může být přizpůsobena vašim potřebám.
následující vzorek vytvoří jednoduchý sloupcový graf pro tři položky a umístí jej 100 pixelů pod horní část listu.
spuštění tohoto vzorku na listu s předchozí tabulce vytvoří následující graf:
Pro více informací, viz Práce s grafy pomocí Excel JavaScript API.