Office アドインでの JavaScript オブジェクトモデルのPowerPoint

PowerPoint JavaScript API を使用すると、アドインでプレゼンテーション、スライド、図形、テキスト、テーブルの読み取りと変更を行うことができます。この記事では、操作するオブジェクトモデルと、PowerPoint アドインのビルドに使用するキーオブジェクトについて説明します。

PowerPointの Office.js API

PowerPoint アドインは、Office JavaScript API を使用してPowerPoint内のオブジェクトと対話します。これには、次の 2 つの JavaScript オブジェクトモデルが含まれます。

PowerPoint JavaScript API: PowerPoint JavaScript API には、プレゼンテーション、スライド、テーブル、図形、書式設定などを操作する厳密に型指定されたオブジェクトが用意されています。 PowerPoint API の非同期性とプレゼンテーションでの動作については、「アプリケーション固有の API モデルの使用」を参照してください。
共通 API: 共通 API は、複数の Office アプリケーション間で共通の UI、ダイアログ、クライアント設定などの機能にアクセスできます。共通 API の使用の詳細については、「共通 JavaScript API オブジェクトモデル」を参照してください。

PowerPoint JavaScript API を使用して、PowerPointを対象とするアドインの機能の大部分を開発する可能性は高くなりますが、Common API のオブジェクトも使用します。例:

Office.Context: Office.Context オブジェクトはアドインのランタイム環境を表し、API のキーオブジェクトへのアクセスを提供します。 contentLanguageやofficeThemeなどのプレゼンテーション構成の詳細で構成され、hostやplatformなどのアドインのランタイム環境に関する情報も提供します。さらに、requirements.isSetSupported() メソッドを提供します。これを使用して、指定した要件セットがアドインが実行されているPowerPoint アプリケーションでサポートされているかどうかをチェックできます。
Office.Document: Office.Document オブジェクトには、アドインが実行されているPowerPoint ファイルのダウンロードに使用できる getFileAsync() メソッドが用意されています。また、プレゼンテーションが "読み取り" ビューか "編集" ビューかをチェックするために使用できる、getActiveViewAsync() メソッドも提供されます。 "編集" は、スライドを編集できる任意のビュー (標準、スライド並べ替えツール、またはアウトラインビュー) に対応します。 "読み取り" は、スライドショーまたは閲覧ビューのいずれかに対応します。

PowerPoint API を理解するには、プレゼンテーションの主要コンポーネントが相互にどのように関連しているかを理解する必要があります。

次の表は、PowerPoint JavaScript API のキーオブジェクトの一覧です。

オブジェクト	説明
Presentation	最上位のオブジェクト。スライド、タグ、プレゼンテーション全体の設定にアクセスできます。
Slide	1 つのスライド。図形とそのレイアウト参照を格納します。
SlideCollection	プレゼンテーション内のスライドのコレクション。
Shape	テキストボックス、画像、線、幾何学的図形などのスライド上の図形。
TextRange	図形内のテキスト。テキストの読み取りと編集に使用します。
SlideLayout	スライドのコンテンツの配置方法を決定するレイアウト。
SlideMaster	既定の書式設定と使用可能なレイアウトを定義するマスター。

PowerPoint JavaScript API でサポートされているオブジェクトの完全なセットについては、「PowerPoint JavaScript API」を参照してください。

このページはお役に立ちましたか?