Excel JavaScript-objektmodell I Office-Tillegg

• 09/03/2020
• 4 minutter å lese
• • o
  • R
  • a
  • l
  • m
  • +4

Denne artikkelen beskriver hvordan Du bruker Excel JavaScript API til å bygge tillegg For Excel 2016 eller nyere. Det introduserer kjernekonsepter som er grunnleggende for Å bruke API og gir veiledning for å utføre bestemte oppgaver som å lese eller skrive til et stort område, oppdatere alle celler i rekkevidde og mer.

Kontor.js Apier For Excel

Et Excel-tillegg samhandler med objekter i Excel ved Hjelp Av Office JavaScript API, som inkluderer To JavaScript-objektmodeller:

• Excel JavaScript API: Introdusert Med Office 2016, Excel JavaScript API gir sterkt skrevet objekter som du kan bruke til å få tilgang til regneark, områder, tabeller, diagrammer og mer.

• Vanlige Api-Er: Common API-ER Introdusert Med Office 2013, Og Kan brukes til å få tilgang til funksjoner som BRUKERGRENSESNITT, dialoger og klientinnstillinger som er vanlige på tvers Av Flere Typer Office-programmer.

selv om Du sannsynligvis vil bruke Excel JavaScript API til å utvikle mesteparten av funksjonaliteten i tillegg som er rettet Mot Excel 2016 eller nyere, bruker du også objekter I Den Vanlige API-EN. For eksempel:

• Kontekst: Context – objektet representerer kjøretidsmiljøet i tillegget og gir tilgang til VIKTIGE objekter I API-EN. Den består av arbeidsbok konfigurasjonsdetaljer som contentLanguage og officeTheme og gir også informasjon om add-ins runtime miljø som host og platform. I tillegg gir den requirements.isSetSupported() – metoden, som du kan bruke til å kontrollere om det angitte kravsettet støttes av Excel-programmet der tillegget kjører.
• Dokument: Document – objektet inneholder getFileAsync() – metoden, som du kan bruke til å laste Ned Excel-filen der tillegget kjører.

følgende bilde illustrerer når Du kan bruke Excel JavaScript API ELLER Vanlige Api-Er.

Excel-spesifikk objektmodell

hvis Du vil forstå Excel-Apier, må du forstå hvordan komponentene i en arbeidsbok er relatert til hverandre.

• En Arbeidsbok inneholder ett Eller flere Regneark.
• Et Regneark inneholder samlinger av dataobjektene som finnes i det enkelte arket, og gir tilgang til celler gjennom Områdeobjekter.
• Et Område representerer en gruppe sammenhengende celler.
• Områder brukes til å opprette Og plassere Tabeller, Diagrammer, Figurer og andre datavisualiserings-eller organisasjonsobjekter.
• Arbeidsbøker inneholder samlinger av noen av disse dataobjektene (For Eksempel Tabeller) for Hele Arbeidsboken.

Områder

et område er en gruppe sammenhengende celler i arbeidsboken. Tillegg bruker Vanligvis a1-stilnotasjon (F.eks. B3 For enkeltcellen i kolonne B og rad 3 eller C2:F4 for cellene Fra kolonne C Til F og rad 2 til 4) for å definere områder.

Områder har tre kjerneegenskaper: values, formulas og format. Disse egenskapene får eller angir celleverdier, formler som skal evalueres og den visuelle formateringen av cellene.

Utvalgseksempel

følgende eksempel viser hvordan du oppretter salgsposter. Denne funksjonen bruker Range objekter til å angi verdier, formler og formater.

dette eksemplet oppretter følgende data i gjeldende regneark:

Hvis du vil Ha mer informasjon, kan Du se Arbeide med områder ved Hjelp Av Excel JavaScript API.

Diagrammer, tabeller og andre dataobjekter

Excel JavaScript-Api-Ene kan opprette og manipulere datastrukturer og visualiseringer I Excel. Tabeller og diagrammer er to av de mest brukte objektene, Men Api-ene støtter Pivottabeller, figurer, bilder og mer.

Opprette en tabell

Opprett tabeller ved hjelp av datafylte områder. Formatering og tabellkontroller (for eksempel filtre) brukes automatisk i området.

følgende eksempel oppretter en tabell ved hjelp av områdene fra forrige eksempel.

ved å Bruke denne eksempelkoden i regnearket med de forrige dataene, opprettes følgende tabell:

Hvis du vil Ha mer informasjon, kan Du se Arbeide med tabeller ved Hjelp Av Excel JavaScript API.

Opprette et diagram

Opprett diagrammer for å visualisere dataene i et område. Apiene støtter dusinvis av diagramvarianter, som hver kan tilpasses dine behov.

følgende eksempel oppretter et enkelt kolonnediagram for tre elementer og plasserer det 100 piksler under toppen av regnearket.

Når du Kjører dette eksemplet på regnearket med forrige tabell, opprettes følgende diagram:

Hvis du vil Ha mer informasjon, kan Du se Arbeide med diagrammer ved Hjelp Av Excel JavaScript API.

Se også