ExcelApi 1.19 では、Excel でデータをより適切に視覚化するのに役立つ、グラフと図形の機能が追加されています。 また、 リンクされたデータ型のサポート、 ドット表記、 基本的なセル値の拡張オプションなど、データ型機能の更新も含まれています。
次の表は API の簡潔な概要を示し、後続の API リスト の表は詳細なリストを示しています。
| 機能領域 | 説明 | 関連オブジェクト |
|---|---|---|
| グラフのラベル | グラフ ラベルの外観を制御します。 | ChartDataLabel、 ChartDataLabelAnchor、 ChartLeaderLines、 ChartLeaderLinesFormat |
| リンクされたエンティティ | 外部ソースから Excel に接続されたデータ型のサポートを追加します。 詳細については、「リンクされたエンティティ セル値を作成する」を参照してください | LinkedEntityDataDomain, LinkedEntityDataDomainCollection, LinkedEntityDataDomainCreateOptions, LinkedEntityIdCulture, LinkedEntityLoadServiceRequest |
API リスト
次の表に、Excel JavaScript API 要件セット 1.19 の API を示します。 Excel JavaScript API 要件セット 1.19 以前でサポートされているすべての API の API リファレンス ドキュメントを表示するには、 要件セット 1.19 以前の Excel API を参照してください。
| クラス | フィールド | 説明 |
|---|---|---|
| BasicCardLayout | レイアウト | このレイアウトの種類を表します。 |
| BasicCompactLayout | icon | カードを開くために使用されるアイコンの名前を指定します。 |
| BasicViewLayouts | カード | この値のレイアウトと、カード ビューでのプロパティを表します。 |
| Compact | 値を表す領域が限られているときに使用されるレイアウトを表します。 | |
| BooleanCellValue | レイアウト | このブール値のビューのレイアウト情報を表します。 |
| プロパティ | このブール値の追加プロパティを表します。 | |
| プロバイダー | この BooleanCellValueのデータを提供したサービスを説明する情報を表します。 |
|
| referencedValues |
BooleanCellValue.properties内で参照されるセル値を表します。 |
|
| CardLayoutTwoColumnSection | レイアウト | このセクションのレイアウトの種類を表します。 |
| ChartDataLabel | geometricShapeType | データ ラベルの幾何学的形状の種類を指定します。 |
| getSubstring(start: number, length?: number) | データ ラベルの部分文字列を返します。 | |
| getTailAnchor() | 固定コールアウトとして表示されるデータ ラベルのテール アンカーを返します。 | |
| setHeight(height: number) | データ ラベルの高さをポイント単位で設定します。 | |
| setWidth(width: number) | データ ラベルの幅をポイント単位で設定します。 | |
| showAsStickyCallout | データ ポイントにテール アンカーがアタッチされた吹き出しとしてデータ ラベルを表示するかどうかを指定します。 | |
| ChartDataLabelAnchor | left | アンカーからグラフのデータ ラベルの左端までの距離をポイント単位で指定します。 |
| top | アンカーからグラフのデータ ラベルの上端までの距離をポイント単位で指定します。 | |
| ChartDataLabels | geometricShapeType | データ ラベルの幾何学的形状の種類を指定します。 |
| leaderLines | データ ラベルの引出線を表すオブジェクトを取得します。 | |
| showAsStickyCallout | データ ポイントにテール アンカーがアタッチされた吹き出しとしてデータ ラベルを表示するかどうかを指定します。 | |
| showLeaderLines | データ ラベルに引出線を表示するかどうかを指定します。 | |
| ChartLeaderLines | format | 系列のデータ ラベルの引出線の書式設定を表します。 |
| ChartLeaderLinesFormat | line | グラフの引出線の線の書式設定を表すオブジェクトを取得します。 |
| DoubleCellValue | レイアウト | この倍精度浮動小数点値のビューのレイアウト情報を表します。 |
| numberFormat | この値の表示に使用する数値書式文字列を返します。 | |
| プロパティ | この倍精度浮動小数点値の追加プロパティを表します。 | |
| プロバイダー | この DoubleCellValueのデータを提供したサービスを説明する情報を表します。 |
|
| referencedValues |
DoubleCellValue.properties内で参照されるセル値を表します。 |
|
| JavaScriptCustomFunctionReferenceCellValue | basicType | この値を持つセルに対して Range.valueTypes によって返される値を表します。 |
| basicValue | この値を持つセルに対して Range.values によって返される値を表します。 |
|
| functionType |
FunctionCellValueの種類を表します。 |
|
| id | カスタム関数の ID を表します。 | |
| namespace | カスタム関数によって使用される名前空間を表します。 | |
| type | このセル値の型を表します。 | |
| LinkedEntityDataDomain | dataProvider | リンクされたエンティティ データ ドメインのデータ プロバイダーの名前を取得します。 |
| delete() | このオブジェクトを LinkedEntityDataDomainCollectionから削除します。 |
|
| id | Office アドインによって定義されたリンクされたエンティティ データ ドメインの ID を取得します。 | |
| lastRefreshed | ブックが開かれ、このリンクされたエンティティ データ ドメインの LinkedEntityCellValue オブジェクトが最後に更新されてからの日時 (ローカル タイム ゾーン内) を取得します。 |
|
| loadFunctionId | Office アドインによって定義されたリンクされたエンティティ データ ドメインの LinkedEntityCellValue オブジェクトを解決または更新するためにオンデマンドで呼び出されるカスタム関数の ID を取得します。 |
|
| name | リンクされたエンティティ データ ドメインの名前を取得します。 | |
| periodicRefreshInterval | このリンクされたエンティティ データ ドメインの LinkedEntityCellValue オブジェクトが自動的に更新される頻度を秒単位で取得します。 |
|
| refresh() | このリンクされたエンティティ データ ドメインのすべての LinkedEntityCellValue オブジェクトを更新します。 |
|
| refreshMode | このリンクされたエンティティ データ ドメインの LinkedEntityCellValue オブジェクトをいつどのように更新するかを定義する更新モードを指定します。 |
|
| serviceId | リンクされたエンティティ データ ドメインのサービス ID を取得します。 | |
| supportedRefreshModes | リンクされたエンティティ データ ドメインでサポートされているすべての更新モードを取得します。 | |
| LinkedEntityDataDomainAddedEventArgs | id | ブックに追加されたリンクされたエンティティ データ ドメインの ID を取得します。 |
| serviceId | ブックに追加された、リンクされたエンティティ データ ドメインのサービス ID を取得します。 | |
| source | イベントのソースを取得します。 | |
| type | イベントの種類を取得します。 | |
| LinkedEntityDataDomainCollection | add(options: Excel.LinkedEntityDataDomainCreateOptions) | Office アドインによって定義されたリンクされたエンティティ データ ドメイン オブジェクトをコレクションに追加します。 |
| getCount() | コレクション内のリンクされたエンティティ データ ドメインの数を取得します。 | |
| getItem(id: string) | リンクされたエンティティ データ ドメインをその idで取得します。 |
|
| getItemAt(index: number) | コレクション内のインデックスによって、リンクされたエンティティ データ ドメインを取得します。 | |
| getItemByName(name: string) | リンクされたエンティティ データ ドメインをその nameで取得します。 |
|
| getItemByNameOrNullObject(name: string) | リンクされたエンティティ データ ドメインをその nameで取得します。 |
|
| getItemOrNullObject(id: string) | リンクされたエンティティ データ ドメインをその idで取得します。 |
|
| items | このコレクション内に読み込まれた子アイテムを取得します。 | |
| onLinkedEntityDataDomainAdded | 新しいリンクされたエンティティ データ ドメインがブックに追加されたときに発生します。 | |
| onRefreshCompleted | リンクされたエンティティ データ ドメインの LinkedEntityCellValue オブジェクトを更新する要求が完了したときに発生します。 |
|
| onRefreshModeChanged | リンクされたエンティティ データ ドメインの refreshMode が変更されたときに発生します。 |
|
| refreshAll() | このコレクション内のリンクされているすべてのエンティティ データ ドメインのすべての LinkedEntityCellValue オブジェクトを更新します。 |
|
| LinkedEntityDataDomainCreateOptions | dataProvider | リンクされたエンティティ データ ドメインのデータ プロバイダーの名前を指定します。 |
| id | リンクされたエンティティ データ ドメインの ID を指定します。 | |
| loadFunctionId | このリンクされたエンティティ データ ドメインの LinkedEntityCellValue オブジェクトを解決または更新するためにオンデマンドで呼び出されるカスタム関数の ID を指定します。 |
|
| name | リンクされたエンティティ データ ドメインの名前を指定します。 | |
| periodicRefreshInterval | このリンクされたエンティティ データ ドメインの LinkedEntityCellValue オブジェクトが自動的に更新される頻度を秒単位で指定します。 |
|
| supportedRefreshModes | リンクされたエンティティ データ ドメインでサポートされるすべての更新モードを指定します。 | |
| LinkedEntityDataDomainRefreshCompletedEventArgs | errors | リンクされたエンティティ データ ドメインの LinkedEntityCellValue オブジェクトを更新要求中に発生したエラーを取得します。 |
| id |
LinkedEntityCellValue オブジェクトが更新されたリンクされたエンティティ データ ドメインの ID を取得します。 |
|
| 最新の情報に更新済み | リンクされたエンティティ データ ドメインの LinkedEntityCellValue オブジェクトが正常に更新された場合は true を返し、それ以外の場合はfalseを返します。 |
|
| serviceId |
LinkedEntityCellValue オブジェクトが更新されたリンクされたエンティティ データ ドメインのサービス ID を取得します。 |
|
| source | イベントのソースを取得します。 | |
| type | イベントの種類を取得します。 | |
| LinkedEntityDataDomainRefreshModeChangedEventArgs | id | 更新モードが変更されたリンクされたエンティティ データ ドメインの ID を取得します。 |
| refreshMode | リンクされたエンティティ データ ドメインの新しい更新モードを取得します。 | |
| serviceId | 更新モードが変更されたリンクされたエンティティ データ ドメインのサービス ID を取得します。 | |
| source | イベントのソースを取得します。 | |
| type | イベントの種類を取得します。 | |
| LinkedEntityIdCulture | カルチャ |
LinkedEntityCellValue オブジェクトの作成に使用される言語カルチャを表します。 |
| entityId |
LinkedEntityCellValue オブジェクトの作成に使用されるサービスに固有の識別子を表します。 |
|
| LinkedEntityLoadServiceRequest | domainId |
LinkedEntityCellValue オブジェクトの作成に使用されるサービスに固有のドメインを表します。 |
| entities | 読み込む LinkedEntityCellValue オブジェクトのエンティティ ID とカルチャを表します。 |
|
| LinkedEntityLoadServiceResult | entities | 読み込まれた LinkedEntityCellValue オブジェクトを表します。 |
| Range | getDisplayedCellProperties(cellPropertiesLoadOptions: CellPropertiesLoadOptions) | 各セルのフォント、塗りつぶし、罫線、配置、およびその他のプロパティの表示データをカプセル化する 2D 配列を返します。 |
| StringCellValue | レイアウト | この文字列値のビューのレイアウト情報を表します。 |
| プロパティ | この文字列値の追加プロパティを表します。 | |
| プロバイダー | この StringCellValueのデータを提供したサービスを説明する情報を表します。 |
|
| referencedValues |
StringCellValue.properties内で参照されるセル値を表します。 |
|
| ブック | getActiveShape() | ブック内のアクティブな図形を取得します。 |
| getActiveShapeOrNullObject() | ブック内のアクティブな図形を取得します。 | |
| linkedEntityDataDomains | ブックで使用可能なリンクされたエンティティ データ ドメインのコレクションを返します。 | |
| ワークシート | showDataTypeIcons | ワークシートにデータ型アイコンを表示するかどうかを指定します。 |
関連項目
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
Office Add-ins