Compartilhar via


ExcelScript.Application interface

Representa o aplicativo Excel que gerencia a pasta de trabalho.

Métodos

calculate(calculationType)

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

getCalculationEngineVersion()

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

getCalculationMode()

Devolve o modo de cálculo utilizado no livro, conforme definido pelas constantes em ExcelScript.CalculationMode. Os valores possíveis são: Automatic, em que o Excel controla o recálculo; AutomaticExceptTables, em que o Excel controla o recálculo, mas ignora as alterações nas tabelas; Manual, onde o cálculo é feito quando o utilizador o pede.

getCalculationState()

Retorna o estado de cálculo do aplicativo. Veja ExcelScript.CalculationState para obter detalhes.

getCultureInfo()

Fornece informações com base nas definições atuais da cultura do sistema. Isto inclui os nomes de cultura, a formatação de números e outras definições culturalmente dependentes.

getDecimalSeparator()

Obtém a cadeia utilizada como separador decimal para valores numéricos. Isto baseia-se nas definições locais do Excel.

getIterativeCalculation()

Devolve as definições de cálculo iterativo. No Excel no Windows e Mac, as definições serão aplicadas à Aplicação do Excel. No Excel na Web e noutras plataformas, as definições serão aplicadas ao livro ativo.

getThousandsSeparator()

Obtém a cadeia utilizada para separar grupos de dígitos à esquerda do decimal para valores numéricos. Isto baseia-se nas definições locais do Excel.

getUseSystemSeparators()

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

setCalculationMode(calculationMode)

Devolve o modo de cálculo utilizado no livro, conforme definido pelas constantes em ExcelScript.CalculationMode. Os valores possíveis são: Automatic, em que o Excel controla o recálculo; AutomaticExceptTables, em que o Excel controla o recálculo, mas ignora as alterações nas tabelas; Manual, onde o cálculo é feito quando o utilizador o pede.

Detalhes do método

calculate(calculationType)

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

calculate(calculationType: CalculationType): void;

Parâmetros

calculationType
ExcelScript.CalculationType

Especifica o tipo de cálculo a usar. Veja ExcelScript.CalculationType para obter detalhes.

Retornos

void

Exemplos

/**
 * This script fully recalculates the entire workbook.
 * This code is useful when automatic recalculation is turned off
 * but later parts of the script rely on updated values.
 */
function main(workbook: ExcelScript.Workbook, workbookURL: string) {
  const application = workbook.getApplication();
  application.calculate(ExcelScript.CalculationType.fullRebuild);
}

getCalculationEngineVersion()

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

getCalculationEngineVersion(): number;

Retornos

number

getCalculationMode()

Devolve o modo de cálculo utilizado no livro, conforme definido pelas constantes em ExcelScript.CalculationMode. Os valores possíveis são: Automatic, em que o Excel controla o recálculo; AutomaticExceptTables, em que o Excel controla o recálculo, mas ignora as alterações nas tabelas; Manual, onde o cálculo é feito quando o utilizador o pede.

getCalculationMode(): CalculationMode;

Retornos

getCalculationState()

Retorna o estado de cálculo do aplicativo. Veja ExcelScript.CalculationState para obter detalhes.

getCalculationState(): CalculationState;

Retornos

Exemplos

/**
 * This script uses the fill color of the first cell to indicate the current
 * calculation state of the workbook.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the first cell in the first worksheet.
  const cell = workbook.getWorksheets()[0].getCell(0,0);

  // Get that cell's fill object.
  const cellFill = cell.getFormat().getFill();

  // Set the cell fill based on the calculation state.
  const calcState = workbook.getApplication().getCalculationState();
  switch (calcState) {
    case ExcelScript.CalculationState.pending:
      cellFill.setColor("Red");
      break;
    case ExcelScript.CalculationState.calculating:
      cellFill.setColor("Yellow");
      break;
    case ExcelScript.CalculationState.done:
      cellFill.setColor("Green");
      break;
  }
}

getCultureInfo()

Fornece informações com base nas definições atuais da cultura do sistema. Isto inclui os nomes de cultura, a formatação de números e outras definições culturalmente dependentes.

getCultureInfo(): CultureInfo;

Retornos

getDecimalSeparator()

Obtém a cadeia utilizada como separador decimal para valores numéricos. Isto baseia-se nas definições locais do Excel.

getDecimalSeparator(): string;

Retornos

string

getIterativeCalculation()

Devolve as definições de cálculo iterativo. No Excel no Windows e Mac, as definições serão aplicadas à Aplicação do Excel. No Excel na Web e noutras plataformas, as definições serão aplicadas ao livro ativo.

getIterativeCalculation(): IterativeCalculation;

Retornos

getThousandsSeparator()

Obtém a cadeia utilizada para separar grupos de dígitos à esquerda do decimal para valores numéricos. Isto baseia-se nas definições locais do Excel.

getThousandsSeparator(): string;

Retornos

string

getUseSystemSeparators()

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

getUseSystemSeparators(): boolean;

Retornos

boolean

setCalculationMode(calculationMode)

Devolve o modo de cálculo utilizado no livro, conforme definido pelas constantes em ExcelScript.CalculationMode. Os valores possíveis são: Automatic, em que o Excel controla o recálculo; AutomaticExceptTables, em que o Excel controla o recálculo, mas ignora as alterações nas tabelas; Manual, onde o cálculo é feito quando o utilizador o pede.

setCalculationMode(calculationMode: CalculationMode): void;

Parâmetros

calculationMode
ExcelScript.CalculationMode

Retornos

void