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 في حال عدم وجود أي معرّف.

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

الاسمTypeالوصف
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);

المَعلمات

الاسمTypeالوصف
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)

لاستبدال جميع تكرارات النص المطابق للبحث عن النص باستبدال النص. فإن البحث غير حساس لحالة الأحرف.

المَعلمات

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

استرجاع الكرة

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

التفويض

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

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

replaceAllText(findText, replaceText, matchCase)

لاستبدال جميع تكرارات النص المطابق للبحث عن النص باستبدال النص.

المَعلمات

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

استرجاع الكرة

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

التفويض

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

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