新しい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 プログラム に参加する必要がある場合があります。
API リスト
次の表に、現在プレビュー中のPowerPoint JavaScript API の一覧を示します。 すべてのPowerPoint JavaScript API (プレビュー API と以前にリリースされた API を含む) の完全な一覧については、 すべてのPowerPoint JavaScript API を参照してください。
| クラス | フィールド | 説明 |
|---|---|---|
| AddSlideOptions | index | 新しいスライドを挿入する 0 から始まるインデックスを指定します。 |
| グラフィック | convertToShape() | |
| shape | グラフィックに関連付けられている Shape オブジェクトを返します。 |
|
| PictureAddOptions | height | 図の高さをポイント単位で指定します。 |
| left | 図の左側からスライドの左側までの距離をポイント単位で指定します。 | |
| top | 図の上端からスライドの上端までの距離をポイント単位で指定します。 | |
| width | 図の幅をポイント単位で指定します。 | |
| Presentation | getActiveSlideOrNullObject() | 編集領域に表示されている現在のアクティブなPowerPoint.Slide を返します。 |
| onSlideSelectionChanged | プレゼンテーション内のスライドの選択が変更されたときに発生します。 | |
| sensitivityLabel | プレゼンテーションの秘密度ラベルを返します。 | |
| RequestContext | sensitivityLabelsCatalog | |
| SensitivityLabel | getCurrentOrNullObject() | ユーザーのプレゼンテーションに存在する現在のラベル情報を取得します。 |
| tryToUpdate(labelId: string) | ユーザーのプレゼンテーションで指定された秘密度ラベルに更新しようとします。 | |
| SensitivityLabelDetails | 子供 | 秘密度ラベルのサブラベルを取得します。 |
| color | 秘密度ラベルの色を取得します。 | |
| id | 秘密度ラベルの一意の ID を取得します。 | |
| 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 | 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