Class NotesPage

NotesPage

صفحة ملاحظات في عرض تقديمي

تحتوي هذه الصفحات على محتوى منشورات العرض التقديمي، بما في ذلك شكل يحتوي على ملاحظات المتحدث في الشريحة. تحتوي كل شريحة على صفحة ملاحظات مقابلة. كما أن النص الموجود في تعديل شكل ملاحظات المحاضر.

الطُرق

الطريقةنوع الإرجاعوصف قصير
getGroups()Group[]عرض قائمة عناصر Group في الصفحة.
getImages()Image[]عرض قائمة عناصر Image في الصفحة.
getLines()Line[]عرض قائمة عناصر Line في الصفحة.
getObjectId()Stringالحصول على المعرّف الفريد للصفحة
getPageElementById(id)PageElementعرض PageElement في الصفحة ذات المعرّف المحدد أو عرض null في حالة عدم وجوده.
getPageElements()PageElement[]تعرض قائمة عناصر PageElement المعروضة على الصفحة.
getPlaceholder(placeholderType)PageElementعرض عنصر العنصر النائب PageElement لعنصر PlaceholderType محدد أو null في حال عدم توفّر عنصر نائب مطابق
getPlaceholder(placeholderType, placeholderIndex)PageElementلعرض العنصر النائب PageElement لعنصر PlaceholderType محدد فهرس العنصر النائب، أو null إذا لم يكن العنصر النائب موجودًا.
getPlaceholders()PageElement[]عرض قائمة كائنات PageElement النائبة في الصفحة.
getShapes()Shape[]عرض قائمة عناصر Shape في الصفحة.
getSheetsCharts()SheetsChart[]عرض قائمة عناصر SheetsChart في الصفحة.
getSpeakerNotesShape()Shapeالحصول على الشكل الذي يحتوي على ملاحظات المحاضر على الصفحة
getTables()Table[]عرض قائمة عناصر Table في الصفحة.
getVideos()Video[]عرض قائمة عناصر Video في الصفحة.
getWordArts()WordArt[]عرض قائمة عناصر WordArt في الصفحة.
replaceAllText(findText, replaceText)Integerلاستبدال جميع مثيلات مطابقة النص (البحث عن النص) باستبدال النص.
replaceAllText(findText, replaceText, matchCase)Integerلاستبدال جميع مثيلات مطابقة النص (البحث عن النص) باستبدال النص.

الوثائق التفصيلية

getGroups()

عرض قائمة عناصر Group في الصفحة.

الإرجاع

Group[]

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getImages()

عرض قائمة عناصر Image في الصفحة.

الإرجاع

Image[]

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getLines()

عرض قائمة عناصر Line في الصفحة.

الإرجاع

Line[]

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getObjectId()

الحصول على المعرّف الفريد للصفحة تتشارك أرقام تعريف الكائنات المستخدمة بواسطة الصفحات وعناصر الصفحة في نفس مساحة الاسم.

الإرجاع

String

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getPageElementById(id)

عرض PageElement في الصفحة ذات المعرّف المحدد أو عرض null في حالة عدم وجوده.

المعلمات

الاسمالنوعالوصف
idStringرقم تعريف عنصر الصفحة الذي يتم استرداده.

الإرجاع

PageElement — عنصر الصفحة الذي يحمل المعرّف المحدّد.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getPageElements()

تعرض قائمة عناصر PageElement المعروضة على الصفحة.

الإرجاع

PageElement[]

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getPlaceholder(placeholderType)

عرض عنصر العنصر النائب PageElement لعنصر PlaceholderType محدد أو null في حال عدم توفّر عنصر نائب مطابق

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

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var placeholder = slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE);

المعلمات

الاسمالنوعالوصف
placeholderTypePlaceholderType

الإرجاع

PageElement

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getPlaceholder(placeholderType, placeholderIndex)

لعرض العنصر النائب PageElement لعنصر PlaceholderType محدد فهرس العنصر النائب، أو null إذا لم يكن العنصر النائب موجودًا.

إذا كان هناك العديد من العناصر النائبة من نفس النوع والفهرس، فسيتم عرض العنصر الأول من مجموعة عناصر الصفحة الخاصة بالصفحة.

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var placeholder = slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE, 0);

المعلمات

الاسمالنوعالوصف
placeholderTypePlaceholderType
placeholderIndexInteger

الإرجاع

PageElement

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getPlaceholders()

عرض قائمة كائنات PageElement النائبة في الصفحة.

var master = SlidesApp.getActivePresentation().getMasters()[0];
Logger.log('Number of placeholders in the master: ' + master.getPlaceholders().length);

الإرجاع

PageElement[]

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getShapes()

عرض قائمة عناصر Shape في الصفحة.

الإرجاع

Shape[]

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getSheetsCharts()

عرض قائمة عناصر SheetsChart في الصفحة.

الإرجاع

SheetsChart[]

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getSpeakerNotesShape()

الحصول على الشكل الذي يحتوي على ملاحظات المحاضر على الصفحة

الإرجاع

Shape

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getTables()

عرض قائمة عناصر Table في الصفحة.

الإرجاع

Table[]

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getVideos()

عرض قائمة عناصر Video في الصفحة.

الإرجاع

Video[]

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

getWordArts()

عرض قائمة عناصر WordArt في الصفحة.

الإرجاع

WordArt[]

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

replaceAllText(findText, replaceText)

لاستبدال جميع مثيلات مطابقة النص (البحث عن النص) باستبدال النص. البحث عبارة عن حالة غير حساسة.

المعلمات

الاسمالنوعالوصف
findTextStringالنص الذي تبحث عنه.
replaceTextStringالنص المطلوب استبدال النص المتطابق.

الإرجاع

Integer - تم تغيير عدد مرات الورود

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations

replaceAllText(findText, replaceText, matchCase)

لاستبدال جميع مثيلات مطابقة النص (البحث عن النص) باستبدال النص.

المعلمات

الاسمالنوعالوصف
findTextStringالنص الذي تبحث عنه.
replaceTextStringالنص المطلوب استبدال النص المتطابق.
matchCaseBooleanإذا كان true، يكون البحث حسّاسًا لحالة الأحرف. إذا كانت القيمة false، تكون عملية البحث حساس لحالة الأحرف.

الإرجاع

Integer - تم تغيير عدد مرات الورود

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/presentations.currentonly
  • https://www.googleapis.com/auth/presentations