如何以编程方式操控 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\",}"
复制

请求 URL

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

响应主体

{<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>}
复制

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";

// 创建 PostAddNotesSlideRequest 对象以向 PPTX 文件添加备注
PostAddNotesSlideRequest postAddNotesSlideRequest = new PostAddNotesSlideRequest();
// 需要添加笔记的文件名称
postAddNotesSlideRequest.Name = fileName;
// 在 PowerPoint 演示文稿中的幻灯片索引
postAddNotesSlideRequest.SlideIndex = 1;
// NotesSlide object
postAddNotesSlideRequest.Dto = notesSlide;

// 将 NotesSlideRequest 添加到 SlidesApi 实例
slidesApi.PostAddNotesSlide(postAddNotesSlideRequest);
复制

更新幻灯片备注

您还可以使用 API 来更新 PowerPoint 演示文稿中的备注。为了满足此要求，使用 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\"    }  }}"
复制

请求 URL

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

响应主体

{<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>}
复制

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 = "Notes updated using Aspose.Slides Cloud API";

// 创建 PutUpdateNotesSlideRequest 对象以更新 PPTX 文件中的备注
PutUpdateNotesSlideRequest putUpdateNotesSlideRequest = new PutUpdateNotesSlideRequest();

// 需要更新笔记的文件名
putUpdateNotesSlideRequest.Name = fileName;
// 在 PowerPoint 演示文稿中的幻灯片索引
putUpdateNotesSlideRequest.SlideIndex = 1;
// NotesSlide object
putUpdateNotesSlideRequest.Dto = notesSlide;

// 将 PutUpdateNotesSlideRequest 添加到 SlidesApi 实例
slidesApi.PutUpdateNotesSlide(putUpdateNotesSlideRequest);
复制

阅读幻灯片备注

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>"
复制

Response body

响应主体显示从 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>}
复制

如果您需要读取请求正文中提供的文档的备注幻灯片信息，请尝试使用 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>"
复制

将幻灯片笔记转换为特定图像格式

您可能会遇到一个要求，将包含注释的PowerPoint幻灯片呈现为特定图像格式。为了满足这一要求，您需要使用 GetNotesSlideWithFormat API 方法。

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 "
复制

请求 URL

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

因此，响应体包含一个转换后的图像，如下所示。