Class NotesPage

صفحةالملاحظات

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

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

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
getGroups()Group[]تعرض هذه الطريقة قائمة بعناصر Group في الصفحة.
getImages()Image[]تعرض هذه الطريقة قائمة بعناصر Image في الصفحة.
getLines()Line[]تعرض هذه الطريقة قائمة بعناصر Line في الصفحة.
getObjectId()Stringتعرض هذه السمة المعرّف الفريد للصفحة.
getPageElementById(id)PageElement|nullتعرض هذه الدالة PageElement في الصفحة التي تحمل المعرّف المحدّد، أو null إذا لم يكن هناك أي عنصر.
getPageElements()PageElement[]تعرض هذه الطريقة قائمة بعناصر PageElement المعروضة على الصفحة.
getPlaceholder(placeholderType)PageElement|nullتعرض هذه الدالة العنصر النائب PageElement الخاص بـ PlaceholderType أو null المحدّدَين، أو تعرض null إذا لم يتوفّر عنصر نائب مطابق.
getPlaceholder(placeholderType, placeholderIndex)PageElement|nullتعرض هذه الدالة العنصر النائب 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|null: عنصر الصفحة الذي يتضمّن المعرّف المحدّد

التفويض

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

  • 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 المحدّدَين، أو تعرض null إذا لم يتوفّر عنصر نائب مطابق.

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

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

المعلمات

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

الإرجاع

PageElement|null

التفويض

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

  • 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|null

التفويض

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

  • 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