Como Manipular Programaticamente Notas em Slides do PowerPoint

Notas são um dos componentes integrais enquanto você está criando uma apresentação. Você adiciona as notas do orador para se referir mais tarde ao entregar o slideshow na frente de uma audiência. Durante a apresentação, as notas do orador são visíveis em seu monitor, mas não são visíveis para o público. Assim, o painel de Notas é o lugar para armazenar os pontos de discussão que você deseja mencionar ao fazer sua apresentação.

Aspose.Slides Cloud oferece as capacidades de adicionar, atualizar ou remover notas de slides do PowerPoint. Você pode realizar a operação em slides do PowerPoint disponíveis no disco rígido do sistema local ou armazenados em armazenamento em nuvem.

Adicionar Notas aos Slides

Para adicionar notas, você precisa tentar usar NotesSlide/PostAddNotesSlide. O seguinte comando cURL permite que você adicione notas aos slides do 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

Request URL

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

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>}
copy

C#.NET code snippet

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

// inicializar objeto Aspose.Slides Cloud
SlidesApi slidesApi = new SlidesApi(MyAppSid, MyAppKey);
String fileName = "NotesPresentation.pptx";            

// Objetos dto NotesSlide para representar as notas do Slide
NotesSlide notesSlide = new NotesSlide();
// sample text for the Notes area
notesSlide.Text = "These are sample presenter notes added using Aspose.Slides Cloud";

// Criar objeto PostAddNotesSlideRequest para adicionar notas ao arquivo PPTX
PostAddNotesSlideRequest postAddNotesSlideRequest = new PostAddNotesSlideRequest();
// nome do arquivo ao qual as Notas devem ser adicionadas
postAddNotesSlideRequest.Name = fileName;
// índice do slide dentro da apresentação do PowerPoint
postAddNotesSlideRequest.SlideIndex = 1;
// Objeto NotesSlide
postAddNotesSlideRequest.Dto = notesSlide;

// adicionar NotesSlideRequest à instância SlidesApi
slidesApi.PostAddNotesSlide(postAddNotesSlideRequest);
copy

Atualizar Notas do Slide

Você também pode usar a API para atualizar notas dentro da apresentação do PowerPoint. Para cumprir esse requisito, o NotesSlide/PutUpdateNotesSlide é utilizado.

cURL command

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

Request URL

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

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>}
copy

C#.NET Trecho de código

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

// inicializar objeto Aspose.Slides Cloud
SlidesApi slidesApi = new SlidesApi(MyAppSid, MyAppKey);
String fileName = "NotesPresentation.pptx";            

// Objeto dto NotesSlide para representar as anotações do Slide
NotesSlide notesSlide = new NotesSlide();
// sample text for the Notes area
notesSlide.Text = "Notes updated using Aspose.Slides Cloud API";

// Criar objeto PutUpdateNotesSlideRequest para atualizar notas dentro do arquivo PPTX
PutUpdateNotesSlideRequest putUpdateNotesSlideRequest = new PutUpdateNotesSlideRequest();

// nome do arquivo para o qual as Notas precisam ser atualizadas
putUpdateNotesSlideRequest.Name = fileName;
// índice do slide dentro da apresentação do PowerPoint
putUpdateNotesSlideRequest.SlideIndex = 1;
// Objeto NotesSlide
putUpdateNotesSlideRequest.Dto = notesSlide;

// adicionar PutUpdateNotesSlideRequest à instância do SlidesApi
slidesApi.PutUpdateNotesSlide(putUpdateNotesSlideRequest);
copy

Leia as Notas do Slide

A API de processamento Cloud do PowerPoint também oferece as capacidades de ler as anotações do slide existente. Você só precisa fornecer o nome do arquivo PowerPoint e o índice de um slide do qual precisa ler os detalhes das anotações. O GetNotesSlide permite que você atinja esse requisito.

cURL command

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

Corpo da resposta

O corpo da resposta mostra as notas dos slides analisadas de um slide específico da apresentação do 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

Caso você precise ler informações do slide de notas para um documento fornecido no corpo da solicitação, por favor, tente usar PostGetNotesSlide.

Excluir Anotações do Slide

A API oferece o método DeleteNotesSlide para remover/excluir as notas do slide do PowerPoint.

cURL command

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

Converter Slide de Notas para Formato de Imagem específico

Você pode se deparar com a necessidade de renderizar slides do PowerPoint contendo notas em formatos de imagem específicos. Para atender a essa necessidade, você precisa usar o método GetNotesSlideWithFormat da API.

cURL command

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

Request URL

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

Como resultado, o corpo da resposta contém uma imagem convertida conforme mostrado abaixo.