Excel JavaScript API 1.4 の新機能

  • [アーティクル]

要件セット 1.4 の Excel JavaScript API に新たに追加された機能は次のとおりです。

名前付きアイテムの追加と新しいプロパティ

新しいプロパティ:

  • comment
  • scope - ワークシートまたはブックスコープの項目。
  • worksheet - 名前付き項目のスコープが設定されているワークシートを返します。

新しいメソッド:

  • add(name: string, reference: Range or string, comment: string) - 指定されたスコープのコレクションに新しい名前を追加します。
  • addFormulaLocal(name: string, formula: string, comment: string) - 数式のユーザーのロケールを使用して、指定されたスコープのコレクションに新しい名前を追加します。

Excel 名前空間内の Setting API

Setting オブジェクトは、ドキュメントに永続的に適用される設定のキーと値のペアを表します。 Excel.Setting の機能は Office.Settings と同等ですが、共通 API のコールバック モデルではなくバッチ API 構文を使用します。

API には、キーを介して設定エントリを取得し、add()指定した key:value 設定ペアをブックに追加する場合が含getItem()まれます。

Others

  • テーブルの列名を設定します。
  • テーブルの末尾にテーブル列を追加します。
  • 一度に複数の行をテーブルに追加します。
  • range.getColumnsAfter(count: number) および range.getColumnsBefore(count: number) を使用して、現在の Range オブジェクトの左右にある特定の数の列を取得します。
  • *OrNullObject メソッドとプロパティ: この機能を使用すると、キーを使用してオブジェクトを取得できます。 オブジェクトが存在しない場合、返されるオブジェクトの isNullObject プロパティは true になります。 これにより、開発者は、例外処理を使用してオブジェクトを処理することなく、オブジェクトが存在する場合にチェックできます。 *OrNullObjectメソッドは、ほとんどのコレクション オブジェクトで使用できます。
worksheet.getItemOrNullObject("itemName")

API リスト

次の表に、Excel JavaScript API 要件セット 1.4 の API を示します。 Excel JavaScript API 要件セット 1.4 以前でサポートされているすべての API の API リファレンス ドキュメントを表示するには、「 要件セット 1.4 以前の Excel API」を参照してください。

クラス フィールド 説明
BindingCollection getCount() コレクションに含まれるバインドの数を取得します。
getItemOrNullObject(id: string) ID を使用してバインド オブジェクトを取得します。
ChartCollection getCount() ワークシート上のグラフの数を返します。
getItemOrNullObject(name: string) グラフ名を使用してグラフを取得します。
ChartPointsCollection getCount() 系列に含まれるグラフのポイントの数を返します。
ChartSeriesCollection getCount() コレクションに含まれるデータ系列の数を返します。
NamedItem comment この名前に関連付けられているコメントを指定します。
delete() 指定された名前を削除します。
getRangeOrNullObject() 名前に関連付けられている範囲オブジェクトを返します。
scope 名前の範囲をブックまたは特定のワークシートに指定するかどうかを指定します。
worksheet 名前付きのアイテムの対象になるワークシートを返します。
worksheetOrNullObject 名前付き項目のスコープを設定するワークシートを返します。
NamedItemCollection add(name: string, reference: Range | string, comment?: string) 指定のスコープのコレクションに新しい名前を追加します。
addFormulaLocal(name: string, formula: string, comment?: string) ユーザーのロケールを数式に使用して、指定のスコープのコレクションに新しい名前を追加します。
getCount() コレクションに含まれる名前付きアイテムの数を取得します。
getItemOrNullObject(name: string) 名前を NamedItem 使用してオブジェクトを取得します。
PivotTableCollection getCount() コレクションに含まれるピボット テーブルの数を取得します。
getItemOrNullObject(name: string) 名前に基づいてピボットテーブルを取得します。
Range getIntersectionOrNullObject(anotherRange: Range | string) 指定した範囲の長方形の交差を表す範囲オブジェクトを取得します。
getUsedRangeOrNullObject(valuesOnly?: boolean) 指定した範囲オブジェクトのうち使用されている範囲を返します。
RangeViewCollection getCount() コレクション内のオブジェクトの RangeView 数を取得します。
Setting delete() 設定を削除します。
key 設定の ID を表すキー。
value この設定に格納されている値を表します。
SettingCollection add(key: string, value: string | number | boolean |日付 |any[] |any) 指定した設定をブックに設定または追加します。
getCount() コレクション内の設定の数を取得します。
getItem(key: string) キーを使用して設定エントリを取得します。
getItemOrNullObject(key: string) キーを使用して設定エントリを取得します。
items このコレクション内に読み込まれた子アイテムを取得します。
onSettingsChanged ドキュメントの設定が変更されたときに発生します。
SettingsChangedEventArgs settings 設定変更イベントを Setting 発生させたバインドを表す オブジェクトを取得します。
TableCollection getCount() コレクションに含まれるテーブルの数を取得します。
getItemOrNullObject(key: string) 名前または ID でテーブルを取得します。
TableColumnCollection getCount() 表の列数を取得します。
getItemOrNullObject(key: number | string) 名前または ID によって、列オブジェクトを取得します。
TableRowCollection getCount() 表の行数を取得します。
ブック settings ブックに関連付けられている設定のコレクションを表します。
ワークシート getUsedRangeOrNullObject(valuesOnly?: boolean) 使用範囲とは、値または書式設定が割り当たっているすべてのセルを包含する最小の範囲です。
名 現在のワークシートにスコープされている名前のコレクション。
WorksheetCollection getCount(visibleOnly?: boolean) コレクションに含まれるワークシートの数を取得します。
getItemOrNullObject(key: string) 名前または ID を使用して、ワークシート オブジェクトを取得します。

関連項目