Class NotesMaster

ملاحظاترئيسية

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

تحدّد النماذج الرئيسية للملاحظات أنماط النصوص وعناصر الصفحات التلقائية لجميع صفحات الملاحظات. ملاحظات الصفحات الرئيسية للقراءة فقط.

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
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 عنصر في الصفحة
getTables()	Table[]	عرض قائمة Table عنصر في الصفحة
getVideos()	Video[]	عرض قائمة Video عنصر في الصفحة
getWordArts()	WordArt[]	عرض قائمة WordArt عنصر في الصفحة

مستندات تفصيلية

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: عنصر الصفحة الذي يحمل المعرّف المحدّد

التفويض

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

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

المعلَمات

الاسم	النوع	الوصف
placeholderType	PlaceholderType

الإرجاع

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

المعلَمات

الاسم	النوع	الوصف
placeholderType	PlaceholderType
placeholderIndex	Integer

الإرجاع

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

---

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