JavaScript プレビュー API のPowerPoint
新しい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 を参照してください。
クラス | フィールド | 説明 |
---|---|---|
CustomProperty | delete() | カスタム プロパティを削除します。 |
key | カスタム プロパティを一意に識別する文字列。 | |
type | カスタム プロパティに使用される値の型。 | |
value | カスタム プロパティの値を指定します。 | |
CustomPropertyCollection | add(key: string, value: boolean |日付 |number |string) | 新しい CustomProperty を作成するか、指定したキーを使用してプロパティを更新します。 |
deleteAll() | このコレクション内のすべてのカスタム プロパティを削除します。 | |
getCount() | コレクション内のカスタム プロパティの数を取得します。 | |
getItem(key: string) | キーによって CustomProperty を取得します。 |
|
getItemOrNullObject(key: string) | キーによって CustomProperty を取得します。 |
|
items | このコレクション内に読み込まれた子アイテムを取得します。 | |
CustomXmlPart | delete() | カスタム XML パーツを削除します。 |
getXml() | カスタム XML パーツの XML コンテンツを取得します。 | |
id | カスタム XML パーツの ID。 | |
namespaceUri | カスタム XML パーツの名前空間 URI。 | |
setXml(xml: string) | カスタム XML パーツの XML コンテンツを設定します。 | |
CustomXmlPartCollection | add(xml: string) | コレクションに新しい CustomXmlPart を追加します。 |
getByNamespace(namespaceUri: string) | 名前空間が指定した名前空間に一致する、カスタム XML パーツの新しい範囲のコレクションを取得します。 | |
getCount() | コレクション内のカスタム XML パーツの数を取得します。 | |
getItem(id: string) | ID に基づいて CustomXmlPart を取得します。 |
|
getItemOrNullObject(id: string) | ID に基づいて CustomXmlPart を取得します。 |
|
items | このコレクション内に読み込まれた子アイテムを取得します。 | |
CustomXmlPartScopedCollection | getCount() | このコレクション内のカスタム XML パーツの数を取得します。 |
getItem(id: string) | ID に基づいて CustomXmlPart を取得します。 |
|
getItemOrNullObject(id: string) | ID に基づいて CustomXmlPart を取得します。 |
|
getOnlyItem() | コレクションに含まれる項目が 1 つだけの場合、このメソッドはその項目を返します。 | |
getOnlyItemOrNullObject() | コレクションに含まれる項目が 1 つだけの場合、このメソッドはその項目を返します。 | |
items | このコレクション内に読み込まれた子アイテムを取得します。 | |
DocumentProperties | 著者 | プレゼンテーションの作成者。 |
カテゴリ | プレゼンテーションのカテゴリ。 | |
comments | プレゼンテーションのメタデータの [コメント] フィールド。 | |
company | プレゼンテーションの会社。 | |
creationDate | プレゼンテーションの作成日。 | |
customProperties | プレゼンテーションのカスタム プロパティのコレクション。 | |
キーワード | プレゼンテーションのキーワード。 | |
lastAuthor | プレゼンテーションの最後の作成者。 | |
上司 | プレゼンテーションのマネージャー。 | |
revisionNumber | プレゼンテーションのリビジョン番号。 | |
subject | プレゼンテーションの件名。 | |
title | プレゼンテーションのタイトル。 | |
Presentation | customXmlParts | プレゼンテーションに関連付けられているカスタム XML パーツのコレクションを返します。 |
プロパティ | プレゼンテーションのプロパティを取得します。 | |
Shape | customXmlParts | 図形内のカスタム XML パーツのコレクションを返します。 |
type | この図形の種類を返します。 | |
Slide | customXmlParts | スライド内のカスタム XML パーツのコレクションを返します。 |
exportAsBase64() | スライドを独自のプレゼンテーション ファイルにエクスポートし、Base64 でエンコードされたデータとして返します。 | |
getImageAsBase64(options?: PowerPoint.SlideGetImageOptions) | スライドのイメージをレンダリングします。 | |
SlideGetImageOptions | height | 結果の画像の目的の高さ (ピクセル単位)。 |
width | 結果のイメージの目的の幅 (ピクセル単位)。 | |
SlideLayout | customXmlParts | スライド レイアウト内のカスタム XML パーツのコレクションを返します。 |
SlideMaster | customXmlParts | スライド マスターでカスタム XML パーツのコレクションを返します。 |
関連項目
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
Office Add-ins