新しい PowerPoint JavaScript API は、最初に "プレビュー" で導入され、十分なテストが行われ、ユーザーからのフィードバックが収集された後、特定の番号付き要件セットの一部になります。
注:
プレビュー API は変更されることがあります。運用環境での使用は意図されていません。 試用はテスト環境と開発環境に限定することをお勧めします。 運用環境やビジネス上重要なドキュメントでプレビュー API を使用しないでください。
プレビュー API を使用するには:
-
Office.js コンテンツ配信ネットワーク (CDN) から Office JavaScript API ライブラリのプレビュー版を使用する必要があります。 TypeScript コンパイルおよび IntelliSense の 型定義ファイルは CDN で見つかり、DefinitelyTyped にあります。 これらの種類は、
npm install --save-dev @types/office-js-previewを使用してインストールできます (以前にインストールしたことがある場合は、@types/office-jsの種類を削除してください)。 - 最新の Office ビルドにアクセスするには、 Microsoft 365 Insider Program への参加が必要な場合があります。
API リスト
次の表に、現在プレビュー中の PowerPoint JavaScript API の一覧を示します。 すべての PowerPoint JavaScript API (プレビュー API と以前にリリースされた API を含む) の完全なリストについては、 すべての PowerPoint JavaScript API を参照してください。
| クラス | フィールド | 説明 |
|---|---|---|
| AddSlideOptions | index | 新しいスライドを挿入する 0 から始まるインデックスを指定します。 |
| Graphic | convertToShape() | |
| shape | グラフィックに関連付けられている Shape オブジェクトを返します。 |
|
| PictureAddOptions | height | 画像の高さをポイント単位で指定します。 |
| left | 画像の左側からスライドの左側までの距離をポイント単位で指定します。 | |
| top | 画像の上端からスライドの上端までの距離をポイント単位で指定します。 | |
| width | 画像の幅をポイント単位で指定します。 | |
| Presentation | getActiveSlideOrNullObject() | 編集領域に表示されている現在アクティブな PowerPoint.Slide を返します。 |
| onSlideSelectionChanged | プレゼンテーションのスライドの選択が変更されたときに発生します。 | |
| sensitivityLabel | プレゼンテーションの秘密度ラベルを返します。 | |
| SensitivityLabel | getCurrentOrNullObject() | ユーザーのプレゼンテーションに存在する現在のラベル情報を取得します。 |
| tryToUpdate(labelId: string) | ユーザーのプレゼンテーションで指定された秘密度ラベルに更新しようとします。 | |
| SensitivityLabelAbacAttribute | displayName | ABAC 属性の表示名を取得します。 |
| displayOrder | この ABAC 属性がユーザーに表示されるときに推奨される順序を取得します。 | |
| isActive | この ABAC 属性がアクティブかどうかを取得します。 | |
| isMultiValued | この ABAC 属性に対して複数の値を選択できるかどうかを取得します。 | |
| values | この ABAC 属性で選択可能な値を取得します。 | |
| SensitivityLabelAbacAttributeValue | displayName | ABAC 属性値の表示名を取得します。 |
| displayOrder | ユーザーに表示されたときに、この ABAC 値の属性内の推奨順序を取得します。 | |
| id | ABAC 属性値の一意識別子を取得します。 | |
| isActive | この ABAC 属性値がアクティブかどうかを取得します。 | |
| SensitivityLabelDetails | abacAttributeValues | この秘密度ラベルに現在適用されている属性ベースのアクセス制御 (ABAC) 属性値を取得します。 |
| 子供 | 秘密度ラベルのサブラベルを取得します。 | |
| color | 秘密度ラベルの色を取得します。 | |
| id | 秘密度ラベルの一意の ID を取得します。 | |
| isAbacAttributesRequired | このラベルを適用するために ABAC 属性の選択が必要かどうかを取得します。 | |
| isAbacEnabled | このラベルが属性ベースのアクセス制御 (ABAC) が有効になっているかどうかを取得します。 | |
| isEnabled | ラベルが有効かどうかを示す値を取得します。 | |
| name | 秘密度ラベルの名前を取得します。 | |
| order | 秘密度ラベルの優先度を取得し、最も低い優先度は 0 です。 | |
| protectionType | このラベルによって提供される保護の種類を示す値を取得します。 | |
| siteId | 秘密度ラベルが属するテナントの一意の ID を取得します。 | |
| ヒント | 秘密度ラベルの説明を取得します。 | |
| SensitivityLabelDetailsCollection | getCount() | このコレクション内の PowerPoint.SensitivityLabelDetails オブジェクトの数を取得します。 |
| getItem(id: string) | このコレクションで指定された SensitivityLabelDetails オブジェクトを取得します。 |
|
| getItemAt(index: number) | このコレクション内の指定されたインデックスにある SensitivityLabelDetails オブジェクトを取得します。 |
|
| getItemOrNullObject(id: string) | このコレクションで指定された SensitivityLabelDetails オブジェクトを取得します。 |
|
| items | このコレクション内に読み込まれた子アイテムを取得します。 | |
| SensitivityLabelsCatalog | getAttributes() | 現在のユーザーが使用できる属性ベースのアクセス制御 (ABAC) 属性を取得します。 |
| getLabelingCapability | 秘密度ラベルのカタログが PowerPoint で有効になっているかどうかを取得します。 | |
| getLabels() | 現在のユーザーが使用できる秘密度ラベルを取得します。 | |
| Shape | getGraphicOrNullObject() | この図形が ShapeType.graphic の場合、PowerPoint.Graphic オブジェクトを返します。 |
| ShapeCollection | addPicture(base64EncodedImage: string, options?: PowerPoint.PictureAddOptions) | スライドに画像を追加します。 |
| SlideLayout | delete() | プレゼンテーションからスライド レイアウトを削除します。 |
| SlideMaster | delete() | スライド マスターとすべての子レイアウトをプレゼンテーションから削除します。 |
| SlideSelectionChangedEventArgs | slideIds | 現在選択されているスライドの ID の配列を取得します。 |
関連項目
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
Office Add-ins