Class NotesPage

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 إذا لم يكن هناك أي معرّف.

المَعلمات

الاسم	النوع	الوصف
id	String	معرّف عنصر الصفحة الذي يتم استرجاعه.

الإرجاع

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,
);

المَعلمات

الاسم	النوع	الوصف
placeholderType	PlaceholderType	نوع العنصر النائب المطلوب مطابقته.

الإرجاع

‫PageElement|null: عنصر الصفحة النائب، أو 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,
);

المَعلمات

الاسم	النوع	الوصف
placeholderType	PlaceholderType	نوع العنصر النائب المطلوب مطابقته.
placeholderIndex	Integer	فهرس العنصر النائب المطلوب مطابقته.

الإرجاع

‫PageElement|null: عنصر الصفحة النائب، أو 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)

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

المَعلمات

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

الإرجاع

Integer: تم تغيير عدد مرات الظهور.

التفويض

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

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

---

replaceAllText(findText, replaceText, matchCase)

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

المَعلمات

الاسم	النوع	الوصف
findText	String	النص المطلوب البحث عنه.
replaceText	String	النص الذي سيتم استبدال النص المطابق به
matchCase	Boolean	إذا كانت القيمة true، تكون عملية البحث حسّاسة لحالة الأحرف، وإذا كانت القيمة false، تكون عملية البحث غير حسّاسة لحالة الأحرف.

الإرجاع

Integer: تم تغيير عدد مرات الظهور.

التفويض

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

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