Excel JavaScript object model in Office Add-ins

  • 09/03/2020
  • 4 protokół do czytania
    • o
    • R
    • A
    • l
    • m
    • +4

w tym artykule opisano, jak używać interfejsu API JavaScript programu Excel do tworzenia dodatków do programu Excel 2016 lub nowszego. Wprowadza podstawowe koncepcje, które są fundamentalne dla korzystania z API i zapewnia wskazówki dotyczące wykonywania określonych zadań, takich jak czytanie lub pisanie w dużym zakresie, aktualizowanie wszystkich komórek w zakresie i wiele innych.

ważne

zobacz Korzystanie z modelu API specyficznego dla aplikacji, aby dowiedzieć się o asynchronicznej naturze interfejsów API programu Excel i ich pracy ze skoroszytem.

Biuro.js API dla programu Excel

dodatek Excel współdziała z obiektami w programie Excel za pomocą interfejsu Office JavaScript API, który zawiera dwa modele obiektów JavaScript:

  • interfejs API JavaScript Excel: wprowadzony w Office 2016 interfejs API JavaScript Excel zapewnia silnie wpisane obiekty, których można używać do uzyskiwania dostępu do arkuszy roboczych, zakresów, tabel, wykresów i innych.

  • wspólne interfejsy API: wprowadzony w pakiecie Office 2013 Wspólny interfejs API może być używany do uzyskiwania dostępu do funkcji, takich jak interfejs użytkownika, okna dialogowe i ustawienia klienta, które są wspólne dla wielu typów aplikacji biurowych.

chociaż prawdopodobnie będziesz używać interfejsu API JavaScript programu Excel do rozwijania większości funkcji w dodatkach, które są przeznaczone dla programu Excel 2016 lub nowszego, użyjesz również obiektów we wspólnym interfejsie API. Na przykład:

  • kontekst: obiekt Context reprezentuje środowisko wykonawcze dodatku i zapewnia dostęp do kluczowych obiektów API. Składa się ze szczegółów konfiguracji skoroszytu, takich jak contentLanguage i officeTheme, a także zawiera informacje o środowisku wykonawczym dodatku, takim jak hosti platform. Dodatkowo zapewnia metodę requirements.isSetSupported(), za pomocą której można sprawdzić, czy określony zestaw wymagań jest obsługiwany przez aplikację Excel, w której jest uruchomiony dodatek.
  • dokument: obiekt Document udostępnia metodę getFileAsync(), której można użyć do pobrania pliku Excel, w którym jest uruchomiony dodatek.

poniższy obraz ilustruje, kiedy można używać interfejsu API JavaScript programu Excel lub wspólnych interfejsów API.

model obiektowy specyficzny dla programu Excel

aby zrozumieć interfejsy API programu Excel, musisz zrozumieć, w jaki sposób składniki skoroszytu są ze sobą powiązane.

  • skoroszyt zawiera jeden lub więcej arkuszy.
  • arkusz zawiera kolekcje tych obiektów danych, które są obecne w pojedynczym arkuszu i zapewnia dostęp do komórek za pośrednictwem obiektów zakresu.
  • zakres reprezentuje grupę sąsiadujących komórek.Zakresy
  • służą do tworzenia i umieszczania tabel, wykresów, kształtów i innych wizualizacji danych lub obiektów organizacji.
  • skoroszyty zawierają Kolekcje niektórych z tych obiektów danych (takich jak tabele) dla całego skoroszytu.

zakresy

zakres to grupa sąsiadujących komórek w skoroszycie. Dodatki zazwyczaj używają notacji w stylu A1 (np. B3 dla pojedynczej komórki w kolumnie B i wierszu 3 lub C2:F4 Dla komórek od kolumn C do F i wierszy 2 do 4) do definiowania zakresów.

zakresy mają trzy podstawowe właściwości: values, formulas i format. Te właściwości pobierają lub ustawiają wartości komórek, formuły do oceny i wizualne Formatowanie komórek.

zakres próbka

poniższy przykład pokazuje, jak tworzyć rekordy sprzedaży. Ta funkcja używa obiektów Range do ustawiania wartości, formuł i formatów.

ta próbka tworzy następujące dane w bieżącym arkuszu roboczym:

aby uzyskać więcej informacji, zobacz Praca z zakresami przy użyciu interfejsu API JavaScript programu Excel.

wykresy, tabele i inne obiekty danych

interfejsy API JavaScript programu Excel mogą tworzyć i manipulować strukturami danych i wizualizacjami w programie Excel. Tabele i wykresy to dwa najczęściej używane obiekty, ale interfejsy API obsługują Tabele przestawne, kształty, obrazy i inne.

Tworzenie tabeli

tworzenie tabel przy użyciu zakresów wypełnionych danymi. Formatowanie i kontrolki tabel (takie jak filtry) są automatycznie stosowane do zakresu.

poniższy przykład tworzy tabelę, używając zakresów z poprzedniej próbki.

Korzystanie z tego przykładowego kodu w arkuszu z poprzednimi danymi tworzy następującą tabelę:

aby uzyskać więcej informacji, zobacz Praca z tabelami przy użyciu interfejsu API JavaScript programu Excel.

Tworzenie wykresu

tworzenie wykresów w celu wizualizacji danych w zakresie. API obsługują dziesiątki odmian Wykresów, z których każdy można dostosować do własnych potrzeb.

poniższa próbka tworzy prosty wykres kolumnowy dla trzech elementów i umieszcza go 100 pikseli poniżej góry arkusza roboczego.

uruchomienie tej próbki w arkuszu z poprzednią tabelą tworzy następujący wykres:

aby uzyskać więcej informacji, zobacz Praca z wykresami przy użyciu interfejsu API JavaScript programu Excel.

Zobacz też



+