Excel JavaScript object model v Office Add-ins

  • 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 je contentLanguage a officeTheme, a také poskytuje informace o runtime prostředí doplňku, jako je host a platform. Navíc poskytuje metodu requirements.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 metodu getFileAsync(), 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.

Viz také



+