https://docs.microsoft.com/en-us/javascript/api/excel/excel.application?view=office-js
Represents the Excel application that manages the workbook.
-
Extends
-
OfficeExtension.ClientObject
Properties
calculationMode | Returns the calculation mode used in the workbook, as defined by the constants in Excel.CalculationMode. Possible values are: |
Methods
calculate(calculationType) | Recalculate all currently opened workbooks in Excel. |
load(option) | Queues up a command to load the specified properties of the object. You must call "context.sync()" before reading the properties. |
suspendApiCalculationUntilNextSync() | Suspends calculation until the next "context.sync()" is called. Once set, it is the developer's responsibility to re-calc the workbook, to ensure that any dependencies are propagated. |
Property Details
calculationMode
Returns the calculation mode used in the workbook, as defined by the constants in Excel.CalculationMode. Possible values are: Automatic
, where Excel controls recalculation; AutomaticExceptTables
, where Excel controls recalculation but ignores changes in tables; Manual
, where calculation is done when the user requests it.
[ API set: ExcelApi 1.1 for get, 1.8 for set ]
Method Details
calculate(calculationType)
Recalculate all currently opened workbooks in Excel.
-
calculationType
- Excel.CalculationType
Specifies the calculation type to use. See Excel.CalculationType for details.
Examples
load(option)
Queues up a command to load the specified properties of the object. You must call "context.sync()" before reading the properties.
-
option
- string | string[]
A comma-delimited string or an array of strings that specify the properties/relationships to load.
In addition to this signature, this method has the following signatures:
load(option?: { select?: string; expand?: string; }): Excel.Application
- Where option.select is a comma-delimited string that specifies the properties/relationships to load, and options.expand is a comma-delimited string that specifies the relationships to load.
load(option?: { select?: string; expand?: string; top?: number; skip?: number }): Excel.Application
- Only available on collection types. It is similar to the preceding signature. Option.top specifies the maximum number of collection items that can be included in the result. Option.skip specifies the number of items that are to be skipped and not included in the result. If option.top is specified, the result set will start after skipping the specified number of items.
Examples
suspendApiCalculationUntilNextSync()
Suspends calculation until the next "context.sync()" is called. Once set, it is the developer's responsibility to re-calc the workbook, to ensure that any dependencies are propagated.