Excel.Application class

標籤：top   after   ips   code   data-   sync   ges   present   wrap   

https://docs.microsoft.com/en-us/javascript/api/excel/excel.application?view=office-js

Represents the Excel application that manages the workbook.

[ API set: ExcelApi 1.1 ]

Extends

OfficeExtension.ClientObject

Properties

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 ]

Methods

calculate(calculationType)

Recalculate all currently opened workbooks in Excel. [ API set: ExcelApi 1.1 ]

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. [ API set: ExcelApi 1.6 ]

          toJSON()

Property DetailscalculationMode 

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 ]

TypeScriptCopy

Property ValueExcel.CalculationMode | "Automatic" | "AutomaticExceptTables" | "Manual"Method Detailscalculate(calculationType) 

Recalculate all currently opened workbooks in Excel.

[ API set: ExcelApi 1.1 ]

TypeScriptCopy

Parameters

calculationType

Excel.CalculationType

Specifies the calculation type to use. See Excel.CalculationType for details.

ReturnsvoidExamplesJavaScriptCopy

load(option) 

Queues up a command to load the specified properties of the object. You must call "context.sync()" before reading the properties.

TypeScriptCopy

Parameters

option

string | string[]

A comma-delimited string or an array of strings that specify the properties/relationships to load.

ReturnsExcel.ApplicationRemarks

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.

ExamplesJavaScriptCopy

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.

[ API set: ExcelApi 1.6 ]

TypeScriptCopy

ReturnsvoidtoJSON() TypeScriptCopy

ReturnsExcel.Interfaces.ApplicationData

Excel.Application class