- 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 jakcontentLanguage
iofficeTheme
, a także zawiera informacje o środowisku wykonawczym dodatku, takim jakhost
iplatform
. 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.