powerpoint package

クラス

PowerPoint.Application
PowerPoint.BulletFormat	PowerPoint.ParagraphFormat に添付されているテキストの箇条書きの書式設定プロパティを表します。
PowerPoint.ParagraphFormat	PowerPoint.TextRange に添付されているテキストの段落書式プロパティを表します。
PowerPoint.Presentation
PowerPoint.RequestContext	RequestContext オブジェクトは、PowerPoint アプリケーションへの要求を容易にします。 Office アドインとPowerPoint アプリケーションは 2 つの異なるプロセスで実行されるため、アドインからPowerPoint オブジェクト モデルにアクセスするには、要求コンテキストが必要です。
PowerPoint.Shape	スライド内の 1 つの図形を表します。
PowerPoint.ShapeCollection	図形のコレクションを表します。
PowerPoint.ShapeFill	図形オブジェクトの塗りつぶしの書式設定を表します。
PowerPoint.ShapeFont	図形の TextRange オブジェクトのフォント名、フォント サイズ、色などのフォント属性を表します。
PowerPoint.ShapeLineFormat	図形オブジェクトの線の書式を表します。 画像と幾何学的図形の場合、線の書式設定は図形の境界線を表します。
PowerPoint.Slide	プレゼンテーションの 1 つのスライドを表します。
PowerPoint.SlideCollection	プレゼンテーション内のスライドのコレクションを表します。
PowerPoint.SlideLayout	スライドのレイアウトを表します。
PowerPoint.SlideLayoutCollection	スライドのスライド マスターによって提供されるレイアウトのコレクションを表します。
PowerPoint.SlideMaster	スライドのスライド マスターを表します。
PowerPoint.SlideMasterCollection	プレゼンテーション内のスライド マスターのコレクションを表します。
PowerPoint.Tag	スライド内の 1 つのタグを表します。
PowerPoint.TagCollection	タグのコレクションを表します。
PowerPoint.TextFrame	図形オブジェクトのテキスト フレームを表します。
PowerPoint.TextRange	図形に結合するテキストや、テキストを操作するためのプロパティおよびメソッドが含まれます。

インターフェイス

PowerPoint.AddSlideOptions	新しいスライドを追加するときに使用できるオプションを表します。
PowerPoint.InsertSlideOptions	スライドを挿入するときに使用できるオプションを表します。
PowerPoint.Interfaces.BulletFormatData	bulletFormat.toJSON() を呼び出すことによって返されるデータを記述するインターフェイス。
PowerPoint.Interfaces.BulletFormatLoadOptions	PowerPoint.ParagraphFormat に添付されているテキストの箇条書きの書式設定プロパティを表します。
PowerPoint.Interfaces.BulletFormatUpdateData	bulletFormat.set({ ... }) で使用するために、BulletFormat オブジェクト上のデータを更新するためのインターフェイス。
PowerPoint.Interfaces.CollectionLoadOptions	コレクションのメンバーのサブセットのみのプロパティを読み込む方法を提供します。
PowerPoint.Interfaces.ParagraphFormatData	paragraphFormat.toJSON() を呼び出すことによって返されるデータを記述するインターフェイス。
PowerPoint.Interfaces.ParagraphFormatLoadOptions	PowerPoint.TextRange に添付されているテキストの段落書式プロパティを表します。
PowerPoint.Interfaces.ParagraphFormatUpdateData	paragraphFormat.set({ ... }) で使用するために、ParagraphFormat オブジェクト上のデータを更新するためのインターフェイス。
PowerPoint.Interfaces.PresentationData	presentation.toJSON() を呼び出すことによって返されるデータを記述するインターフェイス。
PowerPoint.Interfaces.PresentationLoadOptions
PowerPoint.Interfaces.ShapeCollectionData	shapeCollection.toJSON() を呼び出すことによって返されるデータを記述するインターフェイス。
PowerPoint.Interfaces.ShapeCollectionLoadOptions	図形のコレクションを表します。
PowerPoint.Interfaces.ShapeCollectionUpdateData	shapeCollection.set({ ... }) で使用するために、ShapeCollection オブジェクト上のデータを更新するためのインターフェイス。
PowerPoint.Interfaces.ShapeData	shape.toJSON() を呼び出すことによって返されるデータを記述するインターフェイス。
PowerPoint.Interfaces.ShapeFillData	shapeFill.toJSON() を呼び出すことによって返されるデータを記述するインターフェイス。
PowerPoint.Interfaces.ShapeFillLoadOptions	図形オブジェクトの塗りつぶしの書式設定を表します。
PowerPoint.Interfaces.ShapeFillUpdateData	shapeFill.set({ ... }) で使用するために、ShapeFill オブジェクト上のデータを更新するためのインターフェイス。
PowerPoint.Interfaces.ShapeFontData	shapeFont.toJSON() を呼び出すことによって返されるデータを記述するインターフェイス。
PowerPoint.Interfaces.ShapeFontLoadOptions	図形の TextRange オブジェクトのフォント名、フォント サイズ、色などのフォント属性を表します。
PowerPoint.Interfaces.ShapeFontUpdateData	shapeFont.set({ ... }) で使用するために、ShapeFont オブジェクト上のデータを更新するためのインターフェイス。
PowerPoint.Interfaces.ShapeLineFormatData	shapeLineFormat.toJSON() を呼び出すことによって返されるデータを記述するインターフェイス。
PowerPoint.Interfaces.ShapeLineFormatLoadOptions	図形オブジェクトの線の書式を表します。 画像と幾何学的図形の場合、線の書式設定は図形の境界線を表します。
PowerPoint.Interfaces.ShapeLineFormatUpdateData	shapeLineFormat.set({ ... }) で使用するために、ShapeLineFormat オブジェクト上のデータを更新するためのインターフェイス。
PowerPoint.Interfaces.ShapeLoadOptions	スライド内の 1 つの図形を表します。
PowerPoint.Interfaces.ShapeScopedCollectionData	shapeScopedCollection.toJSON() を呼び出すことによって返されるデータを記述するインターフェイス。
PowerPoint.Interfaces.ShapeScopedCollectionUpdateData	shapeScopedCollection.set({ ... }) で使用するために、ShapeScopedCollection オブジェクト上のデータを更新するためのインターフェイス。
PowerPoint.Interfaces.ShapeUpdateData	shape.set({ ... }) で使用するために、Shape オブジェクト上のデータを更新するためのインターフェイス。
PowerPoint.Interfaces.SlideCollectionData	slideCollection.toJSON() を呼び出すことによって返されるデータを記述するインターフェイス。
PowerPoint.Interfaces.SlideCollectionLoadOptions	プレゼンテーション内のスライドのコレクションを表します。
PowerPoint.Interfaces.SlideCollectionUpdateData	slideCollection.set({ ... }) で使用するために、SlideCollection オブジェクト上のデータを更新するためのインターフェイス。
PowerPoint.Interfaces.SlideData	slide.toJSON() を呼び出すことによって返されるデータを記述するインターフェイス。
PowerPoint.Interfaces.SlideLayoutCollectionData	slideLayoutCollection.toJSON() を呼び出すことによって返されるデータを記述するインターフェイス。
PowerPoint.Interfaces.SlideLayoutCollectionLoadOptions	スライドのスライド マスターによって提供されるレイアウトのコレクションを表します。
PowerPoint.Interfaces.SlideLayoutCollectionUpdateData	slideLayoutCollection.set({ ... }) で使用するために、SlideLayoutCollection オブジェクト上のデータを更新するためのインターフェイス。
PowerPoint.Interfaces.SlideLayoutData	slideLayout.toJSON() を呼び出すことによって返されるデータを記述するインターフェイス。
PowerPoint.Interfaces.SlideLayoutLoadOptions	スライドのレイアウトを表します。
PowerPoint.Interfaces.SlideLoadOptions	プレゼンテーションの 1 つのスライドを表します。
PowerPoint.Interfaces.SlideMasterCollectionData	slideMasterCollection.toJSON() を呼び出すことによって返されるデータを記述するインターフェイス。
PowerPoint.Interfaces.SlideMasterCollectionLoadOptions	プレゼンテーション内のスライド マスターのコレクションを表します。
PowerPoint.Interfaces.SlideMasterCollectionUpdateData	slideMasterCollection.set({ ... }) で使用するために、SlideMasterCollection オブジェクト上のデータを更新するためのインターフェイス。
PowerPoint.Interfaces.SlideMasterData	slideMaster.toJSON() を呼び出すことによって返されるデータを記述するインターフェイス。
PowerPoint.Interfaces.SlideMasterLoadOptions	スライドのスライド マスターを表します。
PowerPoint.Interfaces.SlideScopedCollectionData	slideScopedCollection.toJSON() を呼び出すことによって返されるデータを記述するインターフェイス。
PowerPoint.Interfaces.SlideScopedCollectionUpdateData	slideScopedCollection.set({ ... }) で使用するために、SlideScopedCollection オブジェクト上のデータを更新するためのインターフェイス。
PowerPoint.Interfaces.TagCollectionData	tagCollection.toJSON() を呼び出すことによって返されるデータを記述するインターフェイス。
PowerPoint.Interfaces.TagCollectionLoadOptions	タグのコレクションを表します。
PowerPoint.Interfaces.TagCollectionUpdateData	tagCollection.set({ ... }) で使用するために、TagCollection オブジェクト上のデータを更新するためのインターフェイス。
PowerPoint.Interfaces.TagData	tag.toJSON() を呼び出すことによって返されるデータを記述するインターフェイス。
PowerPoint.Interfaces.TagLoadOptions	スライド内の 1 つのタグを表します。
PowerPoint.Interfaces.TagUpdateData	tag.set({ ... }) で使用するために、Tag オブジェクト上のデータを更新するためのインターフェイス。
PowerPoint.Interfaces.TextFrameData	textFrame.toJSON() を呼び出すことによって返されるデータを記述するインターフェイス。
PowerPoint.Interfaces.TextFrameLoadOptions	図形オブジェクトのテキスト フレームを表します。
PowerPoint.Interfaces.TextFrameUpdateData	textFrame.set({ ... }) で使用するために、TextFrame オブジェクト上のデータを更新するためのインターフェイス。
PowerPoint.Interfaces.TextRangeData	textRange.toJSON() を呼び出すことによって返されるデータを記述するインターフェイス。
PowerPoint.Interfaces.TextRangeLoadOptions	図形に結合するテキストや、テキストを操作するためのプロパティおよびメソッドが含まれます。
PowerPoint.Interfaces.TextRangeUpdateData	textRange.set({ ... }) で使用するために、TextRange オブジェクト上のデータを更新するためのインターフェイス。
PowerPoint.ShapeAddOptions	図形を追加するときに使用できるオプションを表します。

列挙型

PowerPoint.ConnectorType	線の図形のコネクタの種類を指定します。
PowerPoint.ErrorCodes
PowerPoint.GeometricShapeType	GeometricShape オブジェクトの図形の種類を指定します。
PowerPoint.InsertSlideFormatting	スライドを挿入するときの書式設定オプションを指定します。
PowerPoint.ParagraphHorizontalAlignment	PowerPoint.Shape のPowerPoint.TextFrame の水平方向の配置を表します。
PowerPoint.ShapeAutoSize	許可される自動サイズ変更を決定します。
PowerPoint.ShapeFillType	図形の塗りつぶしの種類を指定します。
PowerPoint.ShapeFontUnderlineStyle	フォントに適用される下線の種類。
PowerPoint.ShapeLineDashStyle	線の実線/点線のスタイルを指定します。
PowerPoint.ShapeLineStyle	線のスタイルを指定します。
PowerPoint.ShapeType	図形の種類を指定します。
PowerPoint.TextVerticalAlignment	PowerPoint.Shape のPowerPoint.TextFrame の垂直方向の配置を表します。 中央揃えのオプションが 1 つ選択されている場合、 TextFrame の内容はグループとして Shape 内で水平方向に中央揃えされます。 テキストの水平方向の配置を変更するには、「 PowerPoint.ParagraphFormat 」および 「PowerPoint.ParagraphHorizontalAlignment」を参照してください。

関数

PowerPoint.createPresentation(base64File)	新しいプレゼンテーションを作成して開きます。 必要に応じて、プレゼンテーションに base64 でエンコードされた .pptx ファイルを事前に設定できます。 [ API set: PowerPointApi 1.1 ]
PowerPoint.run(batch)	新しい RequestContext を使用して、PowerPoint オブジェクト モデルに対してアクションを実行するバッチ スクリプトを実行します。 promise が解決されると、実行中に自動的に割り当てられた追跡対象オブジェクトが解放されます。
PowerPoint.run(object, batch)	以前に作成した API オブジェクトの RequestContext を使用して、PowerPoint オブジェクト モデルに対してアクションを実行するバッチ スクリプトを実行します。 promise が解決されると、実行中に自動的に割り当てられた追跡対象オブジェクトが解放されます。
PowerPoint.run(objects, batch)	以前に作成した API オブジェクトの RequestContext を使用して、PowerPoint オブジェクト モデルに対してアクションを実行するバッチ スクリプトを実行します。

関数の詳細

PowerPoint.createPresentation(base64File)

新しいプレゼンテーションを作成して開きます。 必要に応じて、プレゼンテーションに base64 でエンコードされた .pptx ファイルを事前に設定できます。

[ API set: PowerPointApi 1.1 ]

export function createPresentation(base64File?: string): Promise<void>;

パラメーター

base64File

string

省略可能。 base64 でエンコードされた .pptx ファイル。 既定値は null です。

戻り値

Promise<void>

例

const myFile = <HTMLInputElement>document.getElementById("file");
const reader = new FileReader();

reader.onload = (event) => {
  // Remove the metadata before the base64-encoded string.
  const startIndex = reader.result.toString().indexOf("base64,");
  const copyBase64 = reader.result.toString().substr(startIndex + 7);

  PowerPoint.createPresentation(copyBase64);
};

// Read in the file as a data URL so we can parse the base64-encoded string.
reader.readAsDataURL(myFile.files[0]);

PowerPoint.run(batch)

新しい RequestContext を使用して、PowerPoint オブジェクト モデルに対してアクションを実行するバッチ スクリプトを実行します。 promise が解決されると、実行中に自動的に割り当てられた追跡対象オブジェクトが解放されます。

export function run<T>(batch: (context: PowerPoint.RequestContext) => OfficeExtension.IPromise<T>): OfficeExtension.IPromise<T>;

パラメーター

batch

(context: PowerPoint.RequestContext) => OfficeExtension.IPromise<T>

RequestContext を受け取り、promise を返す関数 (通常は "context.sync()" の結果のみ)。 context パラメーターを使用すると、PowerPoint アプリケーションへの要求が容易になります。 Office アドインとPowerPoint アプリケーションは 2 つの異なるプロセスで実行されるため、アドインからPowerPoint オブジェクト モデルにアクセスするには RequestContext が必要です。

戻り値

OfficeExtension.IPromise<T>

PowerPoint.run(object, batch)

以前に作成した API オブジェクトの RequestContext を使用して、PowerPoint オブジェクト モデルに対してアクションを実行するバッチ スクリプトを実行します。 promise が解決されると、実行中に自動的に割り当てられた追跡対象オブジェクトが解放されます。

export function run<T>(object: OfficeExtension.ClientObject, batch: (context: PowerPoint.RequestContext) => OfficeExtension.IPromise<T>): OfficeExtension.IPromise<T>;

パラメーター

object

OfficeExtension.ClientObject

以前に作成した API オブジェクト。 バッチでは、渡されたオブジェクトと同じ RequestContext が使用されます。つまり、オブジェクトに適用された変更はすべて "context.sync()" によって取得されます。

batch

(context: PowerPoint.RequestContext) => OfficeExtension.IPromise<T>

RequestContext を受け取り、promise を返す関数 (通常は "context.sync()" の結果のみ)。 context パラメーターを使用すると、PowerPoint アプリケーションへの要求が容易になります。 Office アドインとPowerPoint アプリケーションは 2 つの異なるプロセスで実行されるため、アドインからPowerPoint オブジェクト モデルにアクセスするには RequestContext が必要です。

戻り値

OfficeExtension.IPromise<T>

PowerPoint.run(objects, batch)

以前に作成した API オブジェクトの RequestContext を使用して、PowerPoint オブジェクト モデルに対してアクションを実行するバッチ スクリプトを実行します。

export function run<T>(objects: OfficeExtension.ClientObject[], batch: (context: PowerPoint.RequestContext) => OfficeExtension.IPromise<T>): OfficeExtension.IPromise<T>;

パラメーター

objects

OfficeExtension.ClientObject[]

以前に作成した API オブジェクトの配列。 配列は、すべてのオブジェクトが同じコンテキストを共有することを確認するために検証されます。 バッチでは、この共有 RequestContext が使用されます。これは、これらのオブジェクトに適用された変更が "context.sync()" によって取得されることを意味します。

batch

(context: PowerPoint.RequestContext) => OfficeExtension.IPromise<T>

RequestContext を受け取り、promise を返す関数 (通常は "context.sync()" の結果のみ)。 context パラメーターを使用すると、PowerPoint アプリケーションへの要求が容易になります。 Office アドインとPowerPoint アプリケーションは 2 つの異なるプロセスで実行されるため、アドインからPowerPoint オブジェクト モデルにアクセスするには RequestContext が必要です。

戻り値

OfficeExtension.IPromise<T>