Excel.Application interface

Представляет приложение Excel, которое управляет книгой.

Свойства

calculationEngineVersion

Возвращает версию модуля вычислений Excel, использованного для последнего полного пересчета.

calculationMode

Возвращает режим вычислений, используемый в книге в соответствии с константами в Excel. Калкулатионмоде. Возможные значения:Automatic, где Excel управляет пересчетом;AutomaticExceptTables, где Excel контролирует пересчет, но игнорирует изменения в таблицах;Manual, где выполняется расчет, когда пользователь запрашивает его.

calculationState

Возвращает состояние вычисления приложения. Дополнительные сведения см. в статье Excel.CalculationState.

cultureInfo

Предоставляет сведения, основанные на текущих параметрах языковых параметров системы. Сюда входят имена культур, форматирование чисел и другие параметры, зависящие от культуры.

decimalSeparator

Получает строку, используемую в качестве десятичного разделителя для числовых значений. Это основано на локальных параметрах Excel.

iterativeCalculation

Возвращает параметры итеративных вычислений. В Excel для Windows и Mac параметры будут применены к приложению Excel. В Excel на веб-сайте и других платформах параметры будут применены к активной книге.

thousandsSeparator

Получает строку, используемую для разделения групп цифр слева от десятичного разделителя для числовых значений. Это основано на локальных параметрах Excel.

useSystemSeparators

Указывает, включены ли системные разделители Excel. К системным разделителям относятся разделитель целой и дробной части, а также разделитель групп разрядов.

Методы

calculate(calculationType)

Пересчитывает данные во всех открытых в текущий момент книгах Excel.

load(propertyNames)

Добавляет в очередь команду для загрузки указанных свойств объекта. context.sync()Перед чтением свойств необходимо вызвать метод.

suspendApiCalculationUntilNextSync()

Приостанавливает вычисление до вызова следующего "context.sync()". После этого за пересчет книги и распространение всех зависимостей несет ответственность разработчик.

suspendScreenUpdatingUntilNextSync()

Приостанавливает обновление экрана до тех пор, пока context.sync() не будет вызван следующий.

Note: не suspendScreenUpdatingUntilNextSync повторяйте неоднократные вызовы (например, в цикле). Повторные вызовы приведут к мерцанию окна Excel.

Сведения о свойстве

calculationEngineVersion

Возвращает версию модуля вычислений Excel, использованного для последнего полного пересчета.

readonly calculationEngineVersion: number;

Значение свойства

number

calculationMode

Возвращает режим вычислений, используемый в книге в соответствии с константами в Excel. Калкулатионмоде. Возможные значения:Automatic, где Excel управляет пересчетом;AutomaticExceptTables, где Excel контролирует пересчет, но игнорирует изменения в таблицах;Manual, где выполняется расчет, когда пользователь запрашивает его.

calculationMode:
            | CalculationMode
            | "Automatic"
            | "AutomaticExceptTables"
            | "Manual";

Значение свойства

| CalculationMode | "Automatic" | "AutomaticExceptTables" | "Manual"

calculationState

Возвращает состояние вычисления приложения. Дополнительные сведения см. в статье Excel.CalculationState.

readonly calculationState:
            | CalculationState
            | "Done"
            | "Calculating"
            | "Pending";

Значение свойства

| CalculationState | "Done" | "Calculating" | "Pending"

cultureInfo

Предоставляет сведения, основанные на текущих параметрах языковых параметров системы. Сюда входят имена культур, форматирование чисел и другие параметры, зависящие от культуры.

readonly cultureInfo: CultureInfo;

Значение свойства

decimalSeparator

Получает строку, используемую в качестве десятичного разделителя для числовых значений. Это основано на локальных параметрах Excel.

readonly decimalSeparator: string;

Значение свойства

string

iterativeCalculation

Возвращает параметры итеративных вычислений. В Excel для Windows и Mac параметры будут применены к приложению Excel. В Excel на веб-сайте и других платформах параметры будут применены к активной книге.

readonly iterativeCalculation: IterativeCalculation;

Значение свойства

thousandsSeparator

Получает строку, используемую для разделения групп цифр слева от десятичного разделителя для числовых значений. Это основано на локальных параметрах Excel.

readonly thousandsSeparator: string;

Значение свойства

string

useSystemSeparators

Указывает, включены ли системные разделители Excel. К системным разделителям относятся разделитель целой и дробной части, а также разделитель групп разрядов.

readonly useSystemSeparators: boolean;

Значение свойства

boolean

Сведения о методе

calculate(calculationType)

Пересчитывает данные во всех открытых в текущий момент книгах Excel.

calculate(
            calculationType:
                | CalculationType
                | "Recalculate"
                | "Full"
                | "FullRebuild"
        ): void;

Параметры

calculationType
| CalculationType | "Recalculate" | "Full" | "FullRebuild"

Определяет тип расчета, который нужно использовать. Дополнительные сведения см. в статье Excel. Калкулатионтипе.

Возвращаемое значение

void

load(propertyNames)

Добавляет в очередь команду для загрузки указанных свойств объекта. context.sync()Перед чтением свойств необходимо вызвать метод.

load(propertyNames?: string | string[]): void;

Параметры

propertyNames
string | string[]

Строка, разделенная запятыми, или массив строк, указывающий свойства для загрузки.

Возвращаемое значение

void

suspendApiCalculationUntilNextSync()

Приостанавливает вычисление до вызова следующего "context.sync()". После этого за пересчет книги и распространение всех зависимостей несет ответственность разработчик.

suspendApiCalculationUntilNextSync(): void;

Возвращаемое значение

void

suspendScreenUpdatingUntilNextSync()

Приостанавливает обновление экрана до тех пор, пока context.sync() не будет вызван следующий.

Note: не suspendScreenUpdatingUntilNextSync повторяйте неоднократные вызовы (например, в цикле). Повторные вызовы приведут к мерцанию окна Excel.

suspendScreenUpdatingUntilNextSync(): void;

Возвращаемое значение

void