PowerPoint スライドのノートをプログラムで操作する方法

ノートはプレゼンテーションを作成する際の重要な要素の一つです。スライドショーを聴衆の前で行う際に後で参照するためのスピーカーノートを追加します。プレゼンテーション中、スピーカーノートはモニターに表示されますが、聴衆には見えません。したがって、ノートペインは、プレゼンテーションを行う際に言及したいポイントを保存する場所です。

Aspose.Slides Cloud は、PowerPoint スライドにメモを追加、更新、または削除する機能を提供します。ローカルシステムドライブにある PowerPoint スライドや、クラウドストレージに保存されているスライドに対して操作を行うことができます。

スライドにノートを追加する

ノートを追加するには、NotesSlide/PostAddNotesSlideを使用してみる必要があります。次のcURLコマンドを使用すると、PowerPointスライドにノートを追加できます。

curl -X POST "https://api.aspose.cloud/v3.0/slides/NotesPresentation.pptx/slides/1/notesSlide" -H  "accept: application/json" -H  "authorization: Bearer <jwt token>" -H  "Content-Type: application/json" -d "{  \"Text\": \"These are sample presenter notes added using Aspose.Slides Cloud\",}"
copy

リクエストURL

https://api.aspose.cloud/v3.0/slides/NotesPresentation.pptx/slides/1/notesSlide
copy

レスポンスボディ

{<strong>
  </strong>"text":** **"These are sample presenter notes added using Aspose.Slides Cloud",<strong>
  </strong>"shapes":** **{<strong>
    </strong>"uri":** **{<strong>
      </strong>"href":** **"https://api.aspose.cloud/v3.0/slides/NotesPresentation.pptx/slides/1/notesSlide/shapes",<strong>
      </strong>"relation":** **"self"<strong>
    </strong>}<strong>
  </strong>},<strong>
  </strong>"selfUri":** **{<strong>
    </strong>"href":** **"https://api.aspose.cloud/v3.0/slides/NotesPresentation.pptx/slides/1/notesSlide",<strong>
    </strong>"relation":** **"self"<strong>
  </strong>}<strong>
</strong>}
copy

C#.NET コードスニペット

string MyAppKey = "xxxxxxxx";    // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxx";    // Get AppKey and AppSID from https://dashboard.aspose.cloud/

// Aspose.Slides Cloud オブジェクトを初期化します。
SlidesApi slidesApi = new SlidesApi(MyAppSid, MyAppKey);
String fileName = "NotesPresentation.pptx";            

// NotesSlide dto オブジェクトはスライドのノートを表します。
NotesSlide notesSlide = new NotesSlide();
// ノートエリアのサンプルテキスト
notesSlide.Text = "These are sample presenter notes added using Aspose.Slides Cloud";

// PPTXファイルにノートを追加するための PostAddNotesSlideRequest オブジェクトを作成します。
PostAddNotesSlideRequest postAddNotesSlideRequest = new PostAddNotesSlideRequest();
// 追加が必要なノートのファイル名
postAddNotesSlideRequest.Name = fileName;
// PowerPoint プレゼンテーション内のスライドのインデックス
postAddNotesSlideRequest.SlideIndex = 1;
// NotesSlide オブジェクト
postAddNotesSlideRequest.Dto = notesSlide;

// SlidesApi インスタンスに NotesSlideRequest を追加する
slidesApi.PostAddNotesSlide(postAddNotesSlideRequest);
copy

スライドノートを更新する

PowerPoint プレゼンテーション内のノートを更新するために API を使用することもできます。この要件を満たすために、NotesSlide/PutUpdateNotesSlide が使用されます。

cURL コマンド

curl -X PUT "https://api.aspose.cloud/v3.0/slides/NotesPresentation.pptx/slides/1/notesSlide" -H  "accept: application/json" -H  "authorization: Bearer <jwt token>" -H  "Content-Type: application/json" -d "{  \"Text\": \"Notes updated using Aspose.Slides Cloud API\",  \"Shapes\": {    \"Uri\": {      \"Href\": \"https://products.aspose.cloud/slides/curl\",       \"Title\": \"Aspose.Slides Cloud for cURL\"    }  }}"
copy

リクエストURL

https://api.aspose.cloud/v3.0/slides/NotesPresentation.pptx/slides/1/notesSlide
copy

レスポンスボディ

{<strong>
  </strong>"text":** **"Notes updated using Aspose.Slides Cloud API",<strong>
  </strong>"shapes":** **{<strong>
    </strong>"uri":** **{<strong>
      </strong>"href":** **"https://api.aspose.cloud/v3.0/slides/NotesPresentation.pptx/slides/1/notesSlide/shapes",<strong>
      </strong>"relation":** **"self"<strong>
    </strong>}<strong>
  </strong>},<strong>
  </strong>"selfUri":** **{<strong>
    </strong>"href":** **"https://api.aspose.cloud/v3.0/slides/NotesPresentation.pptx/slides/1/notesSlide",<strong>
    </strong>"relation":** **"self"<strong>
  </strong>}<strong>
</strong>}
copy

C#.NET コードスニペット

string MyAppKey = "xxxxxxxx";    // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxx";    // Get AppKey and AppSID from https://dashboard.aspose.cloud/

// Aspose.Slides Cloud オブジェクトを初期化する
SlidesApi slidesApi = new SlidesApi(MyAppSid, MyAppKey);
String fileName = "NotesPresentation.pptx";            

// NotesSlide dto オブジェクトはスライドノートを表します。
NotesSlide notesSlide = new NotesSlide();
// Notesエリアのサンプルテキスト
notesSlide.Text = "Notes updated using Aspose.Slides Cloud API";

// PPTXファイル内のノートを更新するために PutUpdateNotesSlideRequest オブジェクトを作成します
PutUpdateNotesSlideRequest putUpdateNotesSlideRequest = new PutUpdateNotesSlideRequest();

// 更新が必要なノートのファイル名
putUpdateNotesSlideRequest.Name = fileName;
// PowerPoint プレゼンテーション内のスライドのインデックス
putUpdateNotesSlideRequest.SlideIndex = 1;
// NotesSlide オブジェクト
putUpdateNotesSlideRequest.Dto = notesSlide;

// SlidesApi インスタンスに PutUpdateNotesSlideRequest を追加します。
slidesApi.PutUpdateNotesSlide(putUpdateNotesSlideRequest);
copy

スライドノートを読む

PowerPoint処理クラウドAPIは、既存のスライドからノートを読み取る機能も提供しています。ノートの詳細を読み取る必要があるスライドのPowerPointファイル名とインデックスを提供するだけで済みます。GetNotesSlideは、この要件を達成するために役立ちます。

cURL コマンド

curl -X GET "https://api.aspose.cloud/v3.0/slides/NotesPresentation.pptx/slides/2/notesSlide" -H  "accept: application/json" -H  "authorization: Bearer <jwt token>"
copy

レスポンスボディ

レスポンスボディは、PowerPointプレゼンテーションの特定のスライドから解析されたスライドノートを示しています。

{<strong>
  </strong>"text":** **"This is second slide of PowerPoint presentation",<strong>
  </strong>"shapes":** **{<strong>
    </strong>"uri":** **{<strong>
      </strong>"href":** **"https://api.aspose.cloud/v3.0/slides/NotesPresentation.pptx/slides/2/notesSlide/shapes",<strong>
      </strong>"relation":** **"self"<strong>
    </strong>}<strong>
  </strong>},<strong>
  </strong>"selfUri":** **{<strong>
    </strong>"href":** **"https://api.aspose.cloud/v3.0/slides/NotesPresentation.pptx/slides/2/notesSlide",<strong>
    </strong>"relation":** **"self"<strong>
  </strong>}<strong>
</strong>}
copy

ドキュメントのリクエスト本文に提供されたノートスライド情報を読み取る必要がある場合は、PostGetNotesSlide を使用してみてください。

スライドのノートを削除する

APIはDeleteNotesSlideメソッドを提供して、PowerPointスライドからノートを削除します。

cURL コマンド

curl -X DELETE "https://api.aspose.cloud/v3.0/slides/NotesPresentation.pptx/slides/1/notesSlide" -H  "accept: application/json" -H  "authorization: Bearer <jwt token>"
copy

ノートスライドを特定の画像形式に変換する

PowerPointのスライドに特定の画像形式でノートを表示する必要があるかもしれません。この要件を満たすために、APIの GetNotesSlideWithFormat メソッドを使用する必要があります。

cURL コマンド

curl -X GET "https://api.aspose.cloud/v3.0/slides/NotesPresentation.pptx/slides/2/notesSlide/Jpeg" -H  "accept: multipart/form-data" -H  "authorization: Bearer "
copy

リクエストURL

https://api.aspose.cloud/v3.0/slides/NotesPresentation.pptx/slides/2/notesSlide/Jpeg
copy

その結果、レスポンスボディには以下に示すように変換された画像が含まれます。