איך לתכנת באופן פרוגרמטי מניפולציות על פתקים בשקפים של 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

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/

// אתחל אובייקט 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";

// Create PostAddNotesSlideRequest object to add Notes to PPTX file
PostAddNotesSlideRequest postAddNotesSlideRequest = new PostAddNotesSlideRequest();
// שם הקובץ אליו נדרשת להוסיף הערות
postAddNotesSlideRequest.Name = fileName;
// מִסְמֶר הַשְׁקָף בְּתוֹךְ מַצָּג פּוּוּרְפוֹינט
postAddNotesSlideRequest.SlideIndex = 1;
// NotesSlide object
postAddNotesSlideRequest.Dto = notesSlide;

// הוסף NotesSlideRequest למופע של SlidesApi
slidesApi.PostAddNotesSlide(postAddNotesSlideRequest);
copy

עדכן את הערות השקפים

אתה יכול גם להשתמש ב-API כדי לעדכן הערות בתוך מצגת 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

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 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();
// sample text for the Notes area
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 processing Cloud API גם מציע את היכולות לקרוא את ההערות משקף קיים. אתה פשוט צריך לספק את שם הקובץ של 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.

מחק הערות שקופית

ה-API מציע את שיטת 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 של ה-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

בקשת URL

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

כתוצאה מכך, גוף התגובה מכיל תמונה מומרת כפי שמוצג למטה.