Class 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 محدّد إذا لم يكن هناك عنصر نائب مطابق

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

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const 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 إذا لم يكن العنصر النائب متوفّرًا

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

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const 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 في الصفحة 

const 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