Excel.Application interface

Representa o aplicativo Excel que gerencia a pasta de trabalho.

Propriedades

calculationEngineVersion

Retorna a versão do mecanismo de cálculo do Excel usada para o último recálculo completo.

calculationMode

Retorna o modo de cálculo usado na pasta de trabalho, conforme definido pelas constantes no Excel. Calculation. Os valores possíveis são:Automatic, onde o Excel controla o recálculo;AutomaticExceptTables, onde o Excel controla o recálculo, mas ignora as alterações nas tabelas;Manual, onde o cálculo é feito quando o usuário solicita.

calculationState

Retorna o estado de cálculo do aplicativo. Para saber detalhes, confira Excel.CalculationState.

cultureInfo

Fornece informações com base nas configurações de cultura do sistema atual. Isso inclui os nomes de cultura, a formatação de números e outras configurações dependentes de cultura.

decimalSeparator

Obtém a cadeia de caracteres usada como o separador decimal para valores numéricos. Isso é baseado nas configurações locais do Excel.

iterativeCalculation

Retorna as configurações do Cálculo iterativo. No Excel em Windows e Mac, as configurações serão aplicadas ao aplicativo Excel. No Excel na Web e em outras plataformas, as configurações serão aplicadas à pasta de trabalho ativa.

thousandsSeparator

Obtém a cadeia de caracteres usada para separar grupos de dígitos à esquerda do decimal para valores numéricos. Isso é baseado nas configurações locais do Excel.

useSystemSeparators

Especifica se os separadores de sistema do Excel estão habilitados. Os separadores de sistema incluem separador decimal e separador de milhar.

Métodos

calculate(calculationType)

Recalcula todas as pastas de trabalho abertas no Excel no momento.

load(propertyNames)

Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync() antes de ler as propriedades.

suspendApiCalculationUntilNextSync()

Suspende o cálculo até que o próximo "context.sync()" seja chamado. Uma vez definido, é responsabilidade do desenvolvedor recalcular a pasta de trabalho, para garantir que todas as dependências sejam propagadas.

suspendScreenUpdatingUntilNextSync()

Suspende a atualização da tela até que o próximo context.sync() seja chamado.

Observação: não chame suspendScreenUpdatingUntilNextSync repetidamente (como em um loop). As chamadas repetidas farão com que a janela do Excel fique de piscar.

Detalhes da propriedade

calculationEngineVersion

Retorna a versão do mecanismo de cálculo do Excel usada para o último recálculo completo.

readonly calculationEngineVersion: number;

Valor da propriedade

number

calculationMode

Retorna o modo de cálculo usado na pasta de trabalho, conforme definido pelas constantes no Excel. Calculation. Os valores possíveis são:Automatic, onde o Excel controla o recálculo;AutomaticExceptTables, onde o Excel controla o recálculo, mas ignora as alterações nas tabelas;Manual, onde o cálculo é feito quando o usuário solicita.

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

Valor da propriedade

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

calculationState

Retorna o estado de cálculo do aplicativo. Para saber detalhes, confira Excel.CalculationState.

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

Valor da propriedade

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

cultureInfo

Fornece informações com base nas configurações de cultura do sistema atual. Isso inclui os nomes de cultura, a formatação de números e outras configurações dependentes de cultura.

readonly cultureInfo: CultureInfo;

Valor da propriedade

decimalSeparator

Obtém a cadeia de caracteres usada como o separador decimal para valores numéricos. Isso é baseado nas configurações locais do Excel.

readonly decimalSeparator: string;

Valor da propriedade

string

iterativeCalculation

Retorna as configurações do Cálculo iterativo. No Excel em Windows e Mac, as configurações serão aplicadas ao aplicativo Excel. No Excel na Web e em outras plataformas, as configurações serão aplicadas à pasta de trabalho ativa.

readonly iterativeCalculation: IterativeCalculation;

Valor da propriedade

thousandsSeparator

Obtém a cadeia de caracteres usada para separar grupos de dígitos à esquerda do decimal para valores numéricos. Isso é baseado nas configurações locais do Excel.

readonly thousandsSeparator: string;

Valor da propriedade

string

useSystemSeparators

Especifica se os separadores de sistema do Excel estão habilitados. Os separadores de sistema incluem separador decimal e separador de milhar.

readonly useSystemSeparators: boolean;

Valor da propriedade

boolean

Detalhes do método

calculate(calculationType)

Recalcula todas as pastas de trabalho abertas no Excel no momento.

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

Parâmetros

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

Especifica o tipo de cálculo a usar. Consulte Excel. Calculatype para obter detalhes.

Retornos

void

load(propertyNames)

Coloca um comando na fila para carregar as propriedades especificadas do objeto. Você deve chamar context.sync() antes de ler as propriedades.

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

Parâmetros

propertyNames
string | string[]

Uma cadeia de caracteres delimitada por vírgula ou uma matriz de cadeias de caracteres que especificam as propriedades a serem carregadas.

Retornos

void

suspendApiCalculationUntilNextSync()

Suspende o cálculo até que o próximo "context.sync()" seja chamado. Uma vez definido, é responsabilidade do desenvolvedor recalcular a pasta de trabalho, para garantir que todas as dependências sejam propagadas.

suspendApiCalculationUntilNextSync(): void;

Retornos

void

suspendScreenUpdatingUntilNextSync()

Suspende a atualização da tela até que o próximo context.sync() seja chamado.

Observação: não chame suspendScreenUpdatingUntilNextSync repetidamente (como em um loop). As chamadas repetidas farão com que a janela do Excel fique de piscar.

suspendScreenUpdatingUntilNextSync(): void;

Retornos

void