Excel JavaScript object model in Office Add-ins

• 09/03/2020
• 4 minuten te lezen
• • o
  • R
  • Een
  • l
  • m
  • +4

in Dit artikel wordt beschreven hoe u de Excel-JavaScript-API te bouwen invoegtoepassingen voor Excel 2016 of later. Het introduceert kernconcepten die fundamenteel zijn voor het gebruik van de API en biedt begeleiding voor het uitvoeren van specifieke taken, zoals lezen of schrijven naar een groot bereik, het bijwerken van alle cellen in het bereik, en meer.

kantoor.js API ‘ s voor Excel

een Excel-invoegtoepassing interageert met objecten in Excel met behulp van de Office JavaScript-API, die twee Javascript-objectmodellen bevat:

• Excel JavaScript API: geà ntroduceerd met Office 2016, de Excel JavaScript API biedt sterk getypte objecten die u kunt gebruiken om toegang te krijgen tot werkbladen, bereiken, tabellen, grafieken en meer.

• gemeenschappelijke API ‘ s: geà ntroduceerd met Office 2013, de gemeenschappelijke API kan worden gebruikt om toegang te krijgen tot functies zoals UI, dialogen en client-instellingen die gemeenschappelijk zijn in meerdere soorten Office-toepassingen.

hoewel u waarschijnlijk gebruik maken van de Excel JavaScript API om de meerderheid van de functionaliteit in add-ins die gericht zijn op Excel 2016 of hoger te ontwikkelen, u zult ook gebruik maken van objecten in de gemeenschappelijke API. Bijvoorbeeld::

• Context :het Context object vertegenwoordigt de runtime-omgeving van de invoegtoepassing en biedt toegang tot belangrijke objecten van de API. Het bestaat uit werkmapconfiguratiedetails zoals contentLanguage en officeTheme en biedt ook informatie over de runtime-omgeving van de invoegtoepassing zoals host en platform. Daarnaast biedt het de requirements.isSetSupported() methode, die u kunt gebruiken om te controleren of de opgegeven vereisten worden ondersteund door de Excel-toepassing waar de invoegtoepassing wordt uitgevoerd.
• Document :het Document object biedt de getFileAsync() methode, die u kunt gebruiken om het Excel-bestand te downloaden waar de invoegtoepassing wordt uitgevoerd.

de volgende afbeelding illustreert wanneer u de Excel JavaScript API of de gewone API ‘ s kunt gebruiken.

Excel-specifiek objectmodel

om de Excel API ‘ s te begrijpen, moet u begrijpen hoe de componenten van een werkmap aan elkaar gerelateerd zijn.

• een werkmap bevat een of meer werkbladen.
• een werkblad bevat verzamelingen van die gegevensobjecten die in het afzonderlijke werkblad aanwezig zijn, en geeft toegang tot cellen via Bereikobjecten.
• een bereik vertegenwoordigt een groep aaneengesloten cellen.
• bereiken worden gebruikt om tabellen, grafieken, vormen en andere gegevensvisualisatie-of organisatieobjecten te maken en te plaatsen.
• werkmappen bevatten verzamelingen van sommige van deze gegevensobjecten (zoals tabellen) voor de gehele werkmap.

bereiken

een bereik is een groep aaneengesloten cellen in de werkmap. Add-ins gebruiken doorgaans notatie in A1-stijl (bijvoorbeeld B3 voor de enkele cel in kolom B en rij 3 of C2:F4 voor de cellen van de kolommen C tot en met F en rijen 2 tot en met 4) om bereiken te definiëren.

bereiken hebben drie kerneigenschappen: values, formulas en format. Deze eigenschappen krijgen of stellen de celwaarden, te evalueren formules en de visuele opmaak van de cellen in.

Range sample

de volgende sample laat zien hoe u verkooprecords maakt. Deze functie gebruikt Range objecten om de waarden, formules en formaten in te stellen.

dit voorbeeld maakt de volgende gegevens aan in het huidige werkblad:

zie werken met bereiken met de Excel JavaScript-API voor meer informatie.

grafieken, tabellen en andere gegevensobjecten

de Excel JavaScript API ‘ s kunnen de datastructuren en visualisaties binnen Excel maken en manipuleren. Tabellen en grafieken zijn twee van de meest gebruikte objecten, maar de API ‘ s ondersteunen draaitabellen, vormen, afbeeldingen en meer.

Maak een tabel

maak tabellen met behulp van met gegevens gevulde bereiken. Opmaak-en tabelbesturingselementen (zoals filters) worden automatisch toegepast op het bereik.

het volgende monster maakt een tabel met de bereiken van het vorige Monster.

met behulp van deze voorbeeldcode op het werkblad met de vorige gegevens wordt de volgende tabel gemaakt:

zie werken met tabellen met de Excel JavaScript-API voor meer informatie.

een grafiek maken

grafieken maken om de gegevens in een bereik te visualiseren. De API ‘ s ondersteunen tientallen grafiek variëteiten, die elk kunnen worden aangepast aan uw behoeften.

het volgende voorbeeld maakt een eenvoudig kolomdiagram voor drie items en plaatst het 100 pixels onder de bovenkant van het werkblad.

het uitvoeren van dit voorbeeld op het werkblad met de vorige tabel maakt het volgende diagram:

zie werken met grafieken met de Excel JavaScript-API voor meer informatie.

zie ook