Excel JavaScript object model in Office Add-ins

• 09/03/2020
• 4 luettavat minuutit
• • 
  • R
  • A
  • l
  • m
  • +4

tässä artikkelissa kuvataan, miten käyttää Excel JavaScript API rakentaa apuohjelmia Excel 2016 tai uudempi. Se esittelee YDINKÄSITTEITÄ, jotka ovat keskeisiä API: n käytön kannalta, ja tarjoaa ohjeita tiettyjen tehtävien suorittamiseen, kuten lukemiseen tai kirjoittamiseen laajalle alueelle, kaikkien kantaman solujen päivittämiseen ja paljon muuta.

toimisto.JS Excel-sovellusliittymät

Excel-lisäosa on vuorovaikutuksessa Excelin objektien kanssa Office JavaScript API: n avulla, joka sisältää kaksi JavaScript-objektimallia:

• Excel JavaScript API: Office 2016: n kanssa käyttöön otettu Excel JavaScript API tarjoaa vahvasti tyypitettyjä esineitä, joita voit käyttää laskentataulukoiden, alueiden, taulukoiden, kaavioiden ja muiden käyttöön.

• yhteiset sovellusliittymät: Office 2013-sovellusliittymän avulla voidaan käyttää ominaisuuksia, kuten käyttöliittymää, dialogeja ja asiakasasetuksia, jotka ovat yhteisiä monentyyppisissä Office-sovelluksissa.

vaikka todennäköisesti käyttää Excel JavaScript API kehittää suurin osa toiminnallisuutta apuohjelmia, jotka tavoite Excel 2016 tai uudempi, Voit myös käyttää esineitä yhteisen API. Esimerkiksi:

• Konteksti: Context objekti edustaa lisäosan ajonaikaista ympäristöä ja tarjoaa pääsyn API: n avainobjekteihin. Se koostuu työkirjojen konfiguraatiotiedoista, kuten contentLanguage ja officeTheme, ja sisältää myös tietoja lisäosan suoritusympäristöstä, kuten host ja platform. Lisäksi se tarjoaa requirements.isSetSupported() – menetelmän, jonka avulla voit tarkistaa, tukeeko määritetty vaatimussarja Excel-sovellusta, jossa lisäosa on käynnissä.
• Document: Document object tarjoaa getFileAsync()-menetelmän, jolla voit ladata Excel-tiedoston, jossa lisäosa on käynnissä.

seuraava kuva havainnollistaa, milloin voit käyttää Excel JavaScript API: a tai yleisiä sovellusliittymiä.

Excel-erityinen objektimalli

Excel-sovellusliittymien ymmärtämiseksi on ymmärrettävä, miten työkirjan komponentit liittyvät toisiinsa.

• työkirja sisältää yhden tai useamman laskentataulukon.
• laskentataulukko sisältää kokoelmat yksittäisessä arkissa olevista tietoobjekteista ja antaa pääsyn soluihin Range-objektien kautta.
• a-alue edustaa yhtenäisten solujen ryhmää.
• alueita käytetään taulukoiden, kaavioiden, muotojen ja muiden tietojen visualisointiin tai organisointiin liittyvien objektien luomiseen ja sijoittamiseen.
• työkirjat sisältävät kokoelmia joistakin näistä tietoobjekteista (kuten taulukoista) koko työkirjasta.

vaihteluväli

a-vaihteluväli on työkirjan vierekkäisten solujen ryhmä. Lisäosat käyttävät tyypillisesti A1-tyylistä merkintää (esim.B3 sarakkeen B ja rivin 3 yksittäiselle solulle tai C2:F4 sarakkeiden C-F ja rivien 2-4 soluille) alueiden määrittelemiseksi.

Vaihteluväleillä on kolme ydinominaisuutta: values, formulas ja format. Nämä ominaisuudet saavat tai asettavat solujen arvot, arvioitavat kaavat ja solujen visuaalisen muotoilun.

Vaihteluvälinäyte

seuraava otos näyttää, miten myyntiennätykset luodaan. Tämä funktio käyttää Range objekteja arvojen, kaavojen ja formaattien asettamiseen.

tämä otos luo seuraavat tiedot nykyiseen laskentataulukkoon:

lisätietoja, Katso Work with ranges using the Excel JavaScript API.

kaaviot, taulukot ja muut dataobjektit

Excel JavaScript-sovellusliittymät voivat luoda ja manipuloida tietorakenteita ja visualisointeja Excelissä. Taulukot ja kaaviot ovat kaksi yleisimmin käytettyä objektia, mutta sovellusliittymät tukevat kääntyviä esineitä, muotoja, kuvia ja paljon muuta.

luodaan taulukko

luodaan taulukoita käyttäen datatäytteisiä vaihteluvälejä. Muotoilut ja pöytäsäätimet (kuten suodattimet) kohdistetaan automaattisesti valikoimaan.

Seuraava otos muodostaa taulukon käyttäen edellisen otoksen vaihteluvälejä.

käyttämällä tätä näytekoodia laskentataulukossa aikaisempien tietojen kanssa luodaan seuraava taulukko:

lisätietoja, Katso Work with tables using the Excel JavaScript API.

luodaan kaavio

luo kaavioita, joilla tiedot visualisoidaan tietyllä alueella. Sovellusliittymät tukevat kymmeniä karttalajikkeita, joista jokainen voidaan räätälöidä tarpeidesi mukaan.

seuraava näyte luo yksinkertaisen sarakekaavion kolmelle kohteelle ja asettaa sen 100 pikselin alapuolelle laskentataulukon yläosaan.

tämän näytteen suorittaminen laskentataulukossa edellisen taulukon kanssa luo seuraavan kaavion:

lisätietoja, Katso Work with charts käyttämällä Excel JavaScript API.

Katso myös