Как программно манипулировать заметками в слайдах 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
копировать

Response Body

{<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
копировать

Response Body

{<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);
копировать

Прочитать заметки слайдов

API обработки PowerPoint в облаке также предлагает возможности для чтения заметок из существующего слайда. Вам просто нужно предоставить имя файла 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>"
копировать

Ответ тела

Тело ответа показывает заметки слайдов, извлеченные из конкретного слайда презентации 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
копировать

В результате тело ответа содержит конвертированное изображение, как показано ниже.