Excel Javascript objektummodell az Office-bővítményekben

• 09/03/2020
• 4 perc olvasni
• • o
  • R
  • A
  • l
  • m
  • +4

ez a cikk leírja, hogyan használhatja az Excel JavaScript API-t az Excel 2016-os vagy újabb verziójához készült bővítmények létrehozásához. Olyan alapvető fogalmakat vezet be, amelyek alapvetőek az API használatához, és útmutatást nyújt olyan konkrét feladatok elvégzéséhez, mint például az olvasás vagy az írás nagy tartományban, a tartományban lévő összes cella frissítése stb.

Iroda.js API-k Excelhez

egy Excel-bővítmény az Office JavaScript API használatával lép interakcióba az Excel objektumaival, amely két JavaScript objektummodellt tartalmaz:

• Excel JavaScript API: Az Office 2016-ban bevezetett Excel JavaScript API erősen gépelt objektumokat biztosít, amelyek segítségével elérheti a munkalapokat, tartományokat, táblázatokat, diagramokat és így tovább.

• Általános API-k: az Office 2013-ban bevezetett közös API-k olyan funkciók elérésére használhatók, mint a felhasználói felület, a párbeszédablakok és az ügyfélbeállítások, amelyek több típusú Office-alkalmazásban gyakoriak.

bár valószínűleg az Excel JavaScript API-t fogja használni az Excel 2016-os vagy újabb verzióját megcélzó bővítmények legtöbb funkciójának fejlesztésére, a közös API-ban lévő objektumokat is használni fogja. Például:

• kontextus: a Context objektum a bővítmény futásidejű környezetét képviseli, és hozzáférést biztosít az API legfontosabb objektumaihoz. Tartalmazza a munkafüzet konfigurációs adatait, például a contentLanguage és a officeTheme, valamint információkat nyújt a bővítmény futásidejű környezetéről, például a host és a platform. Ezenkívül biztosítja a requirements.isSetSupported() módszert, amellyel ellenőrizheti, hogy a megadott követelménykészletet támogatja-e az Excel alkalmazás, ahol a bővítmény fut.
• dokumentum: a Document objektum biztosítja a getFileAsync() módszert, amellyel letöltheti az Excel fájlt, ahol a bővítmény fut.

az alábbi képen látható, hogy mikor használhatja az Excel JavaScript API-t vagy a közös API-kat.

Excel-specifikus objektummodell

az Excel API-k megértéséhez meg kell értenie, hogy a munkafüzet összetevői hogyan kapcsolódnak egymáshoz.

• a munkafüzet egy vagy több munkalapot tartalmaz.
• a munkalap az egyes munkalapokon található adatobjektumok gyűjteményeit tartalmazza, és a Tartományobjektumokon keresztül hozzáférést biztosít a cellákhoz.
• a tartomány összefüggő sejtek csoportját jelenti.
• a tartományok táblázatok, diagramok, alakzatok és egyéb adatmegjelenítési vagy szervezeti objektumok létrehozására és elhelyezésére szolgálnak.
• a munkafüzetek ezen adatobjektumok (például táblázatok) gyűjteményeit tartalmazzák a teljes munkafüzethez.

tartományok

a tartomány a munkafüzet szomszédos celláinak csoportja. A bővítmények általában A1-stílusú jelölést használnak (például B3 a B oszlop és a 3.sor egyetlen cellájához, vagy C2:F4 A C-F oszlop és a 2-4. sor celláihoz) a tartományok meghatározásához.A

tartományoknak három alapvető tulajdonsága van: values, formulas és format. Ezek a tulajdonságok megkapják vagy beállítják a cellaértékeket, az értékelendő képleteket és a cellák vizuális formázását.

tartomány minta

a következő minta bemutatja, hogyan hozhat létre értékesítési rekordokat. Ez a függvény Range objektumokat használ az értékek, képletek és formátumok beállításához.

ez a minta a következő adatokat hozza létre az aktuális munkalapon:

További információ: a tartományok kezelése az Excel JavaScript API használatával.

diagramok, táblázatok és egyéb adatobjektumok

az Excel JavaScript API-k képesek létrehozni és manipulálni az Excel adatstruktúráit és vizualizációit. A táblázatok és diagramok a leggyakrabban használt objektumok közül kettő, de az API-k támogatják a kimutatásokat, alakzatokat, képeket és így tovább.

Táblázat létrehozása

táblázatok létrehozása adatokkal kitöltött tartományok használatával. A formázás és a táblázatvezérlők (például szűrők) automatikusan alkalmazandók a tartományra.

a következő minta táblázatot hoz létre az előző minta tartományainak felhasználásával.

ezzel a mintakóddal a munkalapon az előző adatokkal a következő táblázatot hozza létre:

további információt a táblázatok használata az Excel JavaScript API használatával című témakörben talál.

diagram létrehozása

diagramok létrehozása az adatok tartományon belüli megjelenítéséhez. Az API-k több tucat diagramfajtát támogatnak, amelyek mindegyike testreszabható az Ön igényeinek megfelelően.

a következő minta Egyszerű oszlopdiagramot hoz létre három elemhez, és 100 képponttal a munkalap teteje alá helyezi.

a minta futtatása a munkalapon az előző táblázattal a következő táblázatot hozza létre:

További információ: diagramok kezelése az Excel JavaScript API használatával.

Lásd még