Excel.Application class

最後の完全な再計算に使用した Excel 計算エンジンのバージョンを返します。

readonly calculationEngineVersion: number;

プロパティ値

注釈

[ API セット: ExcelApi 1.9 ]

Excel.CalculationMode の定数で定義されているブックで使用される計算モードを返します。 使用可能な値は、 Automaticです。Excel は再計算を制御します。 AutomaticExceptTables、Excel は再計算を制御しますが、テーブルの変更は無視します。 Manualは、ユーザーが要求したときに計算が実行されます。

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

プロパティ値

注釈

[ API set: ExcelApi 1.1 for get, 1.8 for set ]

アプリケーションの計算の状態を返します。 詳細は「Excel.CalculationState」をご覧ください。

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

プロパティ値

注釈

[ API セット: ExcelApi 1.9 ]

オブジェクトに関連付けられている要求コンテキスト。 これにより、アドインのプロセスが Office ホスト アプリケーションのプロセスに接続されます。

context: RequestContext;

プロパティ値

現在のシステム カルチャ設定に基づいて情報を提供します。 これには、カルチャ名、数値の書式設定、およびその他のカルチャに依存する設定が含まれます。

readonly cultureInfo: Excel.CultureInfo;

プロパティ値

注釈

[ API セット: ExcelApi 1.11 ]

数値の小数点として使用される文字列を取得します。 これは、ローカルの Excel 設定に基づいています。

readonly decimalSeparator: string;

プロパティ値

注釈

[ API セット: ExcelApi 1.11 ]

例

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/50-workbook/culture-info.yaml

await Excel.run(async (context) => {
  context.application.load("decimalSeparator,thousandsSeparator");
  context.application.cultureInfo.numberFormat.load("numberDecimalSeparator,numberGroupSeparator");
  await context.sync();

  // Local settings are set under the "Options > Advanced" menu.
  const localDecimalSeparator = context.application.decimalSeparator;
  const localThousandsSeparator = context.application.thousandsSeparator;

  const systemDecimalSeparator = context.application.cultureInfo.numberFormat.numberDecimalSeparator;
  const systemThousandsSeparator = context.application.cultureInfo.numberFormat.numberGroupSeparator;

  console.log("Local character settings: ");
  console.log(`  Local decimal separator: ${localDecimalSeparator}`);
  console.log(`  Local thousands separator: ${localThousandsSeparator}`);

  console.log("System culture settings: ");
  console.log(`  System decimal separator: ${systemDecimalSeparator}`);
  console.log(`  System thousands separator: ${systemThousandsSeparator}`);
  console.log(`  `);

  await context.sync();
});

反復計算設定を返します。 Windows および Mac 上の Excel では、設定が Excel アプリケーションに適用されます。 Excel on the web やその他のプラットフォームでは、設定がアクティブなブックに適用されます。

readonly iterativeCalculation: Excel.IterativeCalculation;

プロパティ値

注釈

[ API セット: ExcelApi 1.9 ]

数値の小数点の左側にある数字のグループを区切るために使用される文字列を取得します。 これは、ローカルの Excel 設定に基づいています。

readonly thousandsSeparator: string;

プロパティ値

注釈

[ API セット: ExcelApi 1.11 ]

Excel のシステム区切り記号を有効にするかどうかを指定します。 システム区切り記号には、小数点と桁区切り記号が含まれます。

readonly useSystemSeparators: boolean;

プロパティ値

注釈

[ API セット: ExcelApi 1.11 ]

Excel で現在開いているすべてのブックを再計算します。

calculate(calculationType: Excel.CalculationType): void;

パラメーター

戻り値

注釈

[ API セット: ExcelApi 1.1 ]

例

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/90-scenarios/performance-optimization.yaml

await Excel.run(async (context) => {
  context.application.calculate(Excel.CalculationType.full);
});

Excel で現在開いているすべてのブックを再計算します。

calculate(calculationTypeString: "Recalculate" | "Full" | "FullRebuild"): void;

パラメーター

戻り値

注釈

[ API セット: ExcelApi 1.1 ]

例

await Excel.run(async (context) => {
    context.workbook.application.calculate('Full');
    await context.sync();
});

オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、context.sync() を呼び出す必要があります。

load(options?: Excel.Interfaces.ApplicationLoadOptions): Excel.Application;

パラメーター

戻り値

オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、context.sync() を呼び出す必要があります。

load(propertyNames?: string | string[]): Excel.Application;

パラメーター

戻り値

例

await Excel.run(async (context) => {
    const application = context.workbook.application;
    application.load('calculationMode');
    await context.sync();

    console.log(application.calculationMode);
});

オブジェクトの指定されたプロパティを読み込むコマンドを待ち行列に入れます。 プロパティを読み取る前に、context.sync() を呼び出す必要があります。

load(propertyNamesAndPaths?: {
            select?: string;
            expand?: string;
        }): Excel.Application;

パラメーター

戻り値

オブジェクトの複数のプロパティを同時に設定します。 適切なプロパティを持つプレーン オブジェクトまたは同じ型の別の API オブジェクトを渡すことができます。

set(properties: Interfaces.ApplicationUpdateData, options?: OfficeExtension.UpdateOptions): void;

パラメーター

戻り値

既存の読み込まれたオブジェクトに基づいて、オブジェクトに複数のプロパティを同時に設定します。

set(properties: Excel.Application): void;

パラメーター

戻り値

次の context.sync() が呼び出されるまで計算を中断します。 設定されると、依存関係が確実に伝達されるようにブックを再計算するのは開発者の責任です。

suspendApiCalculationUntilNextSync(): void;

戻り値

注釈

[ API セット: ExcelApi 1.6 ]

次の context.sync() が呼び出されるまで、画面の更新を中断します。

注*: suspendScreenUpdatingUntilNextSync を繰り返し呼び出さないでください (ループなど)。 呼び出しを繰り返すと、Excel ウィンドウがちらつきになります。

suspendScreenUpdatingUntilNextSync(): void;

戻り値

注釈

[ API セット: ExcelApi 1.9 ]

例

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/90-scenarios/performance-optimization.yaml

await Excel.run(async (context) => {
  // Recreate the data in the worksheet with random data.
  const sheet = context.workbook.worksheets.getActiveWorksheet();

  const startTime = Date.now();
  console.log("Starting...");

  // If other parts of the sample have toggled screen painting off, this will stop screen updating until context.sync is called.
  if (pauseScreenPainting) {
    context.application.suspendScreenUpdatingUntilNextSync();
  }

  for (let i = 1; i < ROW_COUNT; i++) {
    for (let j = 1; j < COLUMN_COUNT; j++) {
      let cell = sheet.getCell(i, j);
      cell.values = [[i * j * Math.random()]];

      // If other parts of the sample have toggled tracking off, we will avoid tracking this range and having to manage the proxy objects.
      // For more information, see https://video2.skills-academy.com/office/dev/add-ins/concepts/resource-limits-and-performance-optimization#untrack-unneeded-proxy-objects
      if (untrack) {
        cell.untrack();
      }
    }
  }

  await context.sync();

  console.log(`Ending. Adding ${ROW_COUNT * COLUMN_COUNT} cells took ${Date.now() - startTime} milliseconds`);
});

API オブジェクトがJSON.stringify()に渡されたときにより便利な出力を提供するために、JavaScript toJSON() メソッドをオーバーライドします。 (JSON.stringify、それに渡されるオブジェクトの toJSON メソッドを呼び出します)。元の Excel.Application オブジェクトは API オブジェクトですが、 toJSON メソッドは、元のオブジェクトから読み込まれた子プロパティの浅いコピーを含むプレーンな JavaScript オブジェクト ( Excel.Interfaces.ApplicationData として型指定) を返します。

toJSON(): Excel.Interfaces.ApplicationData;

戻り値