ExcelApi 1.12 では、動的配列を追跡し、数式の直接の先例を見つけるための API を追加することで、範囲内の数式のサポートを強化しました。 また、ピボットテーブル フィルターの API コントロールも追加されました。 コメント、カルチャ設定、カスタム プロパティ機能領域でも改善が行われました。
| 機能領域 | 説明 | 関連オブジェクト |
|---|---|---|
| コメント イベント | 追加、変更、削除のイベントをコメント コレクションに追加します。 | CommentCollection |
| 日付と時刻の カルチャ設定 | 日付と時刻の書式設定に関する追加のカルチャ設定にアクセスできます。 | CultureInfo、 NumberFormatInfoアプリケーション |
| 直接の判例 | セルの数式を計算するために使用する範囲を返します。 | Range |
| ピボット フィルター | 値に基づくフィルターをピボットテーブルのフィールドに適用します。 | ピボットフィールド、 ピボットフィルター |
| 範囲のスピル | アドインが 動的配列 の結果に関連付けられている範囲を検索できるようにします。 | Range |
| ワークシート レベルのカスタム プロパティ | カスタム プロパティを、ブック レベルだけでなくワークシート レベルにも範囲指定できます。 | WorksheetCustomProperty、 WorksheetCustomPropertyCollection |
API リスト
次の表に、Excel JavaScript API 要件セット 1.12 の API を示します。 Excel JavaScript API 要件セット 1.12 以前でサポートされているすべての API の API リファレンス ドキュメントを表示するには、 要件セット 1.12 以前の Excel API を参照してください。
| クラス | フィールド | 説明 |
|---|---|---|
| ChartAxisTitle | textOrientation | グラフの軸タイトルに対してテキストを向く角度を指定します。 |
| ChartSeries | getDimensionValues(dimension: Excel.ChartSeriesDimension) | グラフ系列の 1 つのディメンションから値を取得します。 |
| コメント | contentType | コメントのコンテンツ タイプを取得します。 |
| CommentAddedEventArgs | commentDetails | コメント ID と関連する応答の ID を含む CommentDetail 配列を取得します。 |
| source | イベントのソースを指定します。 | |
| type | イベントの種類を取得します。 | |
| worksheetId | イベントが発生したワークシートの ID を取得します。 | |
| CommentChangedEventArgs | changeType | 変更されたイベントのトリガー方法を表す変更の種類を取得します。 |
| commentDetails | コメント ID と関連する応答の ID を含む CommentDetail 配列を取得します。 |
|
| source | イベントのソースを指定します。 | |
| type | イベントの種類を取得します。 | |
| worksheetId | イベントが発生したワークシートの ID を取得します。 | |
| CommentCollection | onAdded | コメントが追加されたときに発生します。 |
| onChanged | 返信が削除された場合など、コメント コレクション内のコメントまたは返信が変更されたときに発生します。 | |
| onDeleted | コメント コレクションでコメントが削除されたときに発生します。 | |
| CommentDeletedEventArgs | commentDetails | コメント ID と関連する応答の ID を含む CommentDetail 配列を取得します。 |
| source | イベントのソースを指定します。 | |
| type | イベントの種類を取得します。 | |
| worksheetId | イベントが発生したワークシートの ID を取得します。 | |
| CommentDetail | commentId | コメントの ID を表します。 |
| replyIds | コメントに属する関連する返信の ID を表します。 | |
| CommentReply | contentType | 返信のコンテンツ タイプ。 |
| CultureInfo | datetimeFormat | カルチャ的に適切な日付と時刻の表示形式を定義します。 |
| DatetimeFormatInfo | dateSeparator | 日付の区切り記号として使用される文字列を取得します。 |
| longDatePattern | 長い日付値の書式文字列を取得します。 | |
| longTimePattern | 長い期間の値の書式文字列を取得します。 | |
| shortDatePattern | 短い日付値の書式文字列を取得します。 | |
| timeSeparator | 時刻の区切り記号として使用される文字列を取得します。 | |
| PivotDateFilter | コンパレーター | コンパレーターは、他の値を比較する静的な値です。 |
| condition | 必要なフィルター条件を定義するフィルターの条件を指定します。 | |
| 排他的 |
true場合、フィルターは条件を満たす項目を除外します。 |
|
| lowerBound |
betweenフィルター条件の範囲の下限。 |
|
| upperBound |
betweenフィルター条件の範囲の上限。 |
|
| wholeDays |
equals、before、after、between フィルター条件で、比較を日単位で行うかどうかを示します。 |
|
| PivotField | applyFilter(フィルター: Excel.PivotFilters) | フィールドの現在のピボットフィルターの 1 つ以上を設定し、フィールドに適用します。 |
| clearAllFilters() | フィールドのすべてのフィルターからすべての条件をクリアします。 | |
| clearFilter(filterType: Excel.PivotFilterType) | 指定された種類のフィールドのフィルターから、既存のすべての抽出条件をクリアします (現在抽出条件が適用されている場合)。 | |
| getFilters() | フィールドに現在適用されているすべてのフィルターを取得します。 | |
| isFiltered(filterType?: Excel.PivotFilterType) | フィールドに適用されたフィルターがあるかどうかを確認します。 | |
| PivotFilters | dateFilter | ピボットフィールドの現在適用されている日付フィルター。 |
| labelFilter | ピボットフィールドに現在適用されているラベル フィルター。 | |
| manualFilter | ピボットフィールドの現在適用されている手動フィルター。 | |
| valueFilter | ピボットフィールドの現在適用されている値フィルター。 | |
| PivotLabelFilter | コンパレーター | コンパレーターは、他の値を比較する静的な値です。 |
| condition | 必要なフィルター条件を定義するフィルターの条件を指定します。 | |
| 排他的 |
true場合、フィルターは条件を満たす項目を除外します。 |
|
| lowerBound |
betweenフィルター条件の範囲の下限。 |
|
| substring |
beginsWith、endsWith、およびcontainsフィルター条件に使用される部分文字列。 |
|
| upperBound |
betweenフィルター条件の範囲の上限。 |
|
| PivotManualFilter | selectedItems | 手動でフィルター処理する選択した項目の一覧。 |
| PivotTable | allowMultipleFiltersPerField | ピボットテーブルが、テーブル内の特定のピボットフィールドに複数のピボットフィルターを適用できるかどうかを指定します。 |
| PivotTableScopedCollection | getCount() | コレクション内のピボットテーブルの数を取得します。 |
| getFirst() | コレクション内の最初のピボットテーブルを取得します。 | |
| getItem(key: string) | 名前に基づいてピボットテーブルを取得します。 | |
| getItemOrNullObject(name: string) | 名前に基づいてピボットテーブルを取得します。 | |
| items | このコレクション内に読み込まれた子アイテムを取得します。 | |
| PivotValueFilter | コンパレーター | コンパレーターは、他の値を比較する静的な値です。 |
| condition | 必要なフィルター条件を定義するフィルターの条件を指定します。 | |
| 排他的 |
true場合、フィルターは条件を満たす項目を除外します。 |
|
| lowerBound |
betweenフィルター条件の範囲の下限。 |
|
| selectionType | フィルターの対象として上位/下位 N 個の項目、上位/下位 N 個のパーセント、上位/下位 N 個の合計を指定します。 | |
| しきい値 | 上位/下位フィルター条件でフィルター処理する項目、パーセント、または合計の "N" しきい値。 | |
| upperBound |
betweenフィルター条件の範囲の上限。 |
|
| value | フィルター処理に使用するフィールドで選択された "値" の名前。 | |
| Range | getDirectPrecedents() | 同じワークシート内または複数のワークシート内で指定した範囲の直接指定の先頭のセルがすべて含まれる範囲を表す WorkbookRangeAreas オブジェクトを返します。 |
| getPivotTables(fullyContained?: boolean) | 範囲に重なるピボットテーブルの範囲のコレクションを取得します。 | |
| getSpillParent() | スピルするセルのアンカー セルを含む範囲オブジェクトを取得します。 | |
| getSpillParentOrNullObject() | スピルされるセルのアンカー セルを含む範囲オブジェクトを取得します。 | |
| getSpillingToRange() | アンカー セルで呼び出されたとき、スピル範囲を含む範囲オブジェクトを取得します。 | |
| getSpillingToRangeOrNullObject() | アンカー セルで呼び出されたとき、スピル範囲を含む範囲オブジェクトを取得します。 | |
| hasSpill | すべてのセルにスピル ボーダーがあるかどうかを表します。 | |
| numberFormatCategories | 各セルの数値形式のカテゴリを表します。 | |
| savedAsArray | すべてのセルが配列数式として保存されるかどうかを表します。 | |
| RangeAreasCollection | getCount() | このコレクション内の RangeAreas オブジェクトの数を取得します。 |
| getItemAt(index: number) | コレクション内の位置に基づいて RangeAreas オブジェクトを返します。 |
|
| items | このコレクション内に読み込まれた子アイテムを取得します。 | |
| WorkbookRangeAreas | addresses | アドレスの配列を A1 スタイルで返します。 |
| areas |
RangeAreasCollection オブジェクトを返します。 |
|
| getRangeAreasBySheet(key: string) | コレクション内のワークシート ID または名前に基づいて RangeAreas オブジェクトを返します。 |
|
| getRangeAreasOrNullObjectBySheet(key: string) | コレクション内のワークシート名または ID に基づいて RangeAreas オブジェクトを返します。 |
|
| 範囲 |
RangeCollection オブジェクト内のこのオブジェクトを構成する範囲を返します。 |
|
| ワークシート | customProperties | ワークシート レベルのカスタム プロパティのコレクションを取得します。 |
| WorksheetCustomProperty | delete() | カスタム プロパティを削除します。 |
| key | カスタム プロパティのキーを取得します。 | |
| value | カスタム プロパティの値を指定します。 | |
| WorksheetCustomPropertyCollection | add(key: string, value: string) | 指定されたキーにマップされる新しいカスタム プロパティを追加します。 |
| getCount() | このワークシートのカスタム プロパティの数を取得します。 | |
| getItem(key: string) | キーを使用してカスタム プロパティ オブジェクトを取得します。大文字と小文字は区別されません。 | |
| getItemOrNullObject(key: string) | キーを使用してカスタム プロパティ オブジェクトを取得します。大文字と小文字は区別されません。 | |
| items | このコレクション内に読み込まれた子アイテムを取得します。 |
関連項目
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
Office Add-ins