كيفية التلاعب بالملاحظات برمجياً في شرائح 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 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/

// تهيئة كائن Aspose.Slides Cloud
SlidesApi slidesApi = new SlidesApi(MyAppSid, MyAppKey);
String fileName = "NotesPresentation.pptx";            

// NotesSlide dto object to represent the Slide notes
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;

// add NotesSlideRequest to SlidesApi instance
slidesApi.PostAddNotesSlide(postAddNotesSlideRequest);
copy

تحديث ملاحظات الشريحة

يمكنك أيضًا استخدام واجهة برمجة التطبيقات لتحديث الملاحظات داخل عرض PowerPoint. من أجل الوفاء بهذا المتطلب، يتم استخدام NotesSlide/PutUpdateNotesSlide.

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

طلب عنوان 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 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/

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

// NotesSlide dto object to represent the Slide notes
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);
copy

اقرأ ملاحظات الشريحة

تقدم واجهة برمجة التطبيقات السحابية لمعالجة PowerPoint أيضًا القدرات اللازمة لقراءة الملاحظات من الشريحة الموجودة. تحتاج ببساطة إلى تقديم اسم ملف PowerPoint ومؤشر الشريحة التي تحتاج إلى قراءة تفاصيل الملاحظات لها. تتيح لك وظيفة GetNotesSlide تحقيق هذا الطلب.

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

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

في حال كنت بحاجة إلى قراءة معلومات شريحة الملاحظات لوثيقة مقدمة في جسم الطلب، يرجى محاولة استخدام PostGetNotesSlide.

حذف ملاحظات الشريحة

تقدم واجهة برمجة التطبيقات DeleteNotesSlide الطريقة لإزالة/حذف الملاحظات من شريحة 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

تحويل شريحة الملاحظات إلى تنسيق صورة معين

قد تصادف حاجة لتحويل شرائح PowerPoint التي تحتوي على ملاحظات إلى تنسيقات صور محددة. من أجل تلبية هذه الحاجة، تحتاج إلى استخدام GetNotesSlideWithFormat طريقة من واجهة برمجة التطبيقات.

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

طلب عنوان URL

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

نتيجةً لذلك، يحتوي جسم الاستجابة على صورة محوّلة كما هو موضح أدناه.