Class SpeakerSpotlight

SpeakerSpotlight

رمز PageElement يمثّل ميزة "تضمين كاميرا المُحاضر".

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const speakerSpotlight = slide.getPageElements()[0];
console.log(
    `Page element is of type: ${
        speakerSpotlight.getPageElementType().toString()}`,
);

الطُرق

الطريقة	نوع القيمة التي تم إرجاعها	وصف قصير
alignOnPage(alignmentPosition)	SpeakerSpotlight	تعمل هذه السمة على محاذاة العنصر مع موضع المحاذاة المحدّد على الصفحة.
bringForward()	SpeakerSpotlight	يقدّم عنصر الصفحة إلى الأمام على الصفحة بمقدار عنصر واحد.
bringToFront()	SpeakerSpotlight	يتم عرض عنصر الصفحة في مقدّمة الصفحة.
duplicate()	PageElement	تكرِّر هذه السمة عنصر الصفحة.
getBorder()	Border	تعرض هذه السمة Border لميزة "تضمين كاميرا المُحاضر".
getConnectionSites()	ConnectionSite[]	تعرض هذه السمة قائمة ConnectionSites في عنصر الصفحة، أو قائمة فارغة إذا كان عنصر الصفحة لا يتضمّن أي مواقع إلكترونية مرتبطة.
getDescription()	String	تعرض هذه السمة وصف النص البديل لعنصر الصفحة.
getHeight()	Number|null	تعرض هذه السمة ارتفاع العنصر بالنقاط، وهو ارتفاع المربّع المحيط بالعنصر عندما لا يكون العنصر مدوّرًا.
getInherentHeight()	Number|null	تعرض هذه السمة الارتفاع المتأصّل للعنصر بالنقاط.
getInherentWidth()	Number|null	تعرض هذه السمة العرض المضمّن للعنصر بالنقاط.
getLeft()	Number	تعرض هذه السمة الموضع الأفقي للعنصر بالنقاط، ويتم قياسه من الزاوية العلوية اليمنى من الصفحة عندما لا يكون العنصر في وضع تدوير.
getMaskShapeType()	ShapeType|null	تعرض هذه السمة ShapeType للقناع الذي تم تطبيقه على تضمين كاميرا المُحاضر، أو null في حال عدم توفّر قناع.
getObjectId()	String	تعرِض هذه السمة المعرّف الفريد لهذا العنصر.
getPageElementType()	PageElementType	تعرض هذه السمة نوع عنصر الصفحة، ويتم تمثيله كقيمة تعداد PageElementType.
getParentGroup()	Group|null	تعرض هذه السمة المجموعة التي ينتمي إليها عنصر الصفحة هذا، أو null إذا لم يكن العنصر في مجموعة.
getParentPage()	Page	تعرض هذه السمة الصفحة التي يظهر عليها عنصر الصفحة هذا.
getRotation()	Number	تعرض هذه السمة زاوية تدوير العنصر في اتجاه عقارب الساعة حول مركزه بالدرجات، حيث تعني الدرجة صفر عدم التدوير.
getTitle()	String	تعرض هذه السمة عنوان النص البديل لعنصر الصفحة.
getTop()	Number	تعرض هذه السمة الموضع الرأسي للعنصر بالنقاط، ويتم قياسه من الزاوية العلوية اليسرى للصفحة عندما لا يكون العنصر مدوّرًا.
getTransform()	AffineTransform	تعرض هذه السمة تحويل عنصر الصفحة.
getWidth()	Number|null	تعرض هذه السمة عرض العنصر بالنقاط، وهو عرض المربّع المحيط بالعنصر عندما لا يكون العنصر مدوّرًا.
preconcatenateTransform(transform)	SpeakerSpotlight	يتم دمج عملية التحويل المقدَّمة مع عملية التحويل الحالية لعنصر الصفحة.
remove()	void	تزيل هذه الطريقة عنصر الصفحة.
scaleHeight(ratio)	SpeakerSpotlight	تغيّر حجم ارتفاع العنصر حسب النسبة المحدّدة.
scaleWidth(ratio)	SpeakerSpotlight	تغيّر حجم عرض العنصر حسب النسبة المحدّدة.
select()	void	يختار هذا الخيار PageElement فقط في العرض التقديمي النشط ويزيل أي اختيار سابق.
select(replace)	void	يختار PageElement في العرض التقديمي النشط.
sendBackward()	SpeakerSpotlight	يرسل عنصر الصفحة إلى الخلف بمقدار عنصر واحد.
sendToBack()	SpeakerSpotlight	يرسل عنصر الصفحة إلى خلف الصفحة.
setDescription(description)	SpeakerSpotlight	تضبط هذه السمة وصف النص البديل لعنصر الصفحة.
setHeight(height)	SpeakerSpotlight	تضبط هذه السمة ارتفاع العنصر بالنقاط، وهو ارتفاع المربّع المحيط بالعنصر عندما لا يكون العنصر مدوّرًا.
setLeft(left)	SpeakerSpotlight	تضبط هذه السمة الموضع الأفقي للعنصر بالنقاط، ويتم قياسه من الزاوية العلوية اليمنى للصفحة عندما لا يكون العنصر في وضع تدوير.
setRotation(angle)	SpeakerSpotlight	تضبط هذه السمة زاوية دوران العنصر في اتجاه عقارب الساعة حول مركزه بالدرجات.
setTitle(title)	SpeakerSpotlight	تضبط هذه السمة عنوان النص البديل لعنصر الصفحة.
setTop(top)	SpeakerSpotlight	تضبط هذه السمة الوضع الرأسي للعنصر بالنقاط، ويتم قياسه من الزاوية العلوية اليسرى للصفحة عندما لا يكون العنصر في وضع تدوير.
setTransform(transform)	SpeakerSpotlight	تضبط هذه السمة تحويل عنصر الصفحة باستخدام التحويل المقدَّم.
setWidth(width)	SpeakerSpotlight	تضبط هذه السمة عرض العنصر بالنقاط، وهو عرض المربّع المحيط بالعنصر عندما لا يكون العنصر مدوّرًا.

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

alignOnPage(alignmentPosition)

تعمل هذه السمة على محاذاة العنصر مع موضع المحاذاة المحدّد على الصفحة.

المعلمات

الاسم	النوع	الوصف
alignmentPosition	AlignmentPosition	تمثّل هذه السمة موضع محاذاة عنصر الصفحة هذا على الصفحة.

الإرجاع

SpeakerSpotlight: عنصر الصفحة هذا، ويُستخدم في الربط.

---

bringForward()

يقدّم عنصر الصفحة إلى الأمام على الصفحة بمقدار عنصر واحد.

يجب ألا يكون عنصر الصفحة في مجموعة.

الإرجاع

SpeakerSpotlight: عنصر الصفحة هذا، ويُستخدم في الربط.

التفويض

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

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

---

bringToFront()

يتم عرض عنصر الصفحة في مقدّمة الصفحة.

يجب ألا يكون عنصر الصفحة في مجموعة.

الإرجاع

SpeakerSpotlight: عنصر الصفحة هذا، ويُستخدم في الربط.

التفويض

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

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

---

duplicate()

تكرِّر هذه السمة عنصر الصفحة.

يتم وضع عنصر الصفحة المكرّرة في الصفحة نفسها وفي الموضع نفسه الذي تم فيه وضع العنصر الأصلي.

الإرجاع

PageElement: النسخة المكرّرة الجديدة من عنصر الصفحة هذا

التفويض

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

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

---

getBorder()

تعرض هذه السمة Border لميزة "تضمين كاميرا المُحاضر".

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// Gets the first element on the page, which in
// this example is of type speaker spotlight.
const speakerSpotlight = slide.getPageElements()[0];
// Gets the border of the speaker spotlight.
const border = speakerSpotlight.getBorder();

الإرجاع

Border: تمثّل حدود "تضمين كاميرا المُحاضر".

التفويض

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

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

---

getConnectionSites()

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

الإرجاع

‫ConnectionSite[]: قائمة المواقع الإلكترونية المرتبطة، والتي قد تكون فارغة إذا لم يكن لهذا العنصر أي مواقع إلكترونية مرتبطة.

التفويض

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

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

---

getDescription()

تعرض هذه السمة وصف النص البديل لعنصر الصفحة. يتم دمج الوصف مع العنوان لعرض النص البديل وقراءته.

الإرجاع

‫String: وصف النص البديل لعنصر الصفحة.

التفويض

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

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

---

getHeight()

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

لا تتوافق هذه الطريقة مع جميع عناصر الصفحة. لمعرفة عناصر الصفحة غير المتوافقة مع هذه الطريقة، يُرجى الرجوع إلى قيود تحديد الحجم والموضع.

الإرجاع

‫Number|null: الارتفاع الأساسي لعنصر الصفحة بالنقاط، أو null إذا لم يكن لعنصر الصفحة ارتفاع.

التفويض

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

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

---

getInherentHeight()

تعرض هذه السمة الارتفاع المتأصّل للعنصر بالنقاط.

يكون تحويل عنصر الصفحة مرتبطًا بحجمه الأصلي. استخدِم الحجم المتأصّل مع تحويل العنصر لتحديد المظهر المرئي النهائي للعنصر.

الإرجاع

‫Number|null: الارتفاع الأساسي لعنصر الصفحة بالنقاط، أو null إذا لم يكن لعنصر الصفحة ارتفاع.

التفويض

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

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

---

getInherentWidth()

تعرض هذه السمة العرض المضمّن للعنصر بالنقاط.

يتم تحويل عنصر الصفحة نسبةً إلى حجمه الأصلي. استخدِم الحجم المتأصّل مع تحويل العنصر لتحديد المظهر المرئي النهائي للعنصر.

الإرجاع

‫Number|null: يمثّل العرض المضمّن لعنصر الصفحة بالنقاط، أو null إذا لم يكن لعنصر الصفحة عرض.

التفويض

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

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

---

getLeft()

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

الإرجاع

‫Number: يمثّل هذا العنصر الموضع الأفقي بالنقاط، بدءًا من الزاوية العلوية اليمنى من الصفحة.

التفويض

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

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

---

getMaskShapeType()

تعرض هذه السمة ShapeType للقناع الذي تم تطبيقه على تضمين كاميرا المُحاضر، أو null في حال عدم توفّر قناع.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// Gets the first element on the page, which in
// this example is of type speaker spotlight.
const speakerSpotlight = slide.getPageElements()[0];
// Gets the shape type of the mask on the speaker spotlight.
const maskShapeType = speakerSpotlight.getMaskShapeType();

الإرجاع

ShapeType|null: نوع شكل قناع "تضمين كاميرا المُحاضر".

التفويض

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

• 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

---

getPageElementType()

تعرض هذه السمة نوع عنصر الصفحة، ويتم تمثيله كقيمة تعداد PageElementType.

الإرجاع

PageElementType: نوع عنصر الصفحة

التفويض

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

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

---

getParentGroup()

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

الإرجاع

Group|null: المجموعة التي ينتمي إليها عنصر الصفحة هذا، أو null

التفويض

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

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

---

getParentPage()

تعرض هذه السمة الصفحة التي يظهر عليها عنصر الصفحة هذا.

الإرجاع

Page: الصفحة التي يظهر عليها هذا العنصر

التفويض

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

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

---

getRotation()

تعرض هذه السمة زاوية تدوير العنصر في اتجاه عقارب الساعة حول مركزه بالدرجات، حيث تعني الدرجة صفر عدم التدوير.

الإرجاع

Number: زاوية الدوران بالدرجات بين 0 (شامل) و360 (غير شامل).

التفويض

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

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

---

getTitle()

تعرض هذه السمة عنوان النص البديل لعنصر الصفحة. يتم دمج العنوان مع الوصف لعرض النص البديل وقراءته.

الإرجاع

String: عنوان النص البديل لعنصر الصفحة

التفويض

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

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

---

getTop()

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

الإرجاع

‫Number: يمثّل هذا العنصر الموضع الرأسي بالنقاط، بدءًا من الزاوية العلوية اليمنى من الصفحة.

التفويض

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

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

---

getTransform()

تعرض هذه السمة تحويل عنصر الصفحة.

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

الإرجاع

AffineTransform: هي عملية تحويل عنصر الصفحة.

التفويض

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

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

---

getWidth()

تعرض هذه السمة عرض العنصر بالنقاط، وهو عرض المربّع المحيط بالعنصر عندما لا يكون العنصر مدوّرًا.

لا تتوافق هذه الطريقة مع جميع عناصر الصفحة. لمعرفة عناصر الصفحة غير المتوافقة مع هذه الطريقة، يُرجى الرجوع إلى قيود تحديد الحجم والموضع.

الإرجاع

‫Number|null: يمثّل العرض المضمّن لعنصر الصفحة بالنقاط، أو null إذا لم يكن لعنصر الصفحة عرض.

التفويض

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

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

---

preconcatenateTransform(transform)

يتم دمج عملية التحويل المقدَّمة مع عملية التحويل الحالية لعنصر الصفحة.

newTransform = argument * existingTransform;

على سبيل المثال، لنقل عناصر الصفحة بمقدار 36 نقطة إلى اليسار:

const element = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
element.preconcatenateTransform(
    SlidesApp.newAffineTransformBuilder().setTranslateX(-36.0).build(),
);

يمكنك أيضًا استبدال تحويل عنصر الصفحة بالرمز setTransform(transform).

المعلمات

الاسم	النوع	الوصف
transform	AffineTransform	التحويل إلى عملية ربط مسبقة بعنصر الصفحة هذا.

الإرجاع

SpeakerSpotlight: عنصر الصفحة هذا، ويُستخدم في الربط.

التفويض

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

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

---

remove()

تزيل هذه الطريقة عنصر الصفحة.

إذا لم تتضمّن Group بعد عملية إزالة سوى عنصر صفحة واحد أو لم تتضمّن أي عناصر، ستتم أيضًا إزالة المجموعة نفسها.

إذا تمت إزالة عنصر نائب PageElement من مستند رئيسي أو تخطيط، ستتم أيضًا إزالة أي عناصر نائبة فارغة موروثة.

التفويض

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

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

---

scaleHeight(ratio)

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

لا تتوافق هذه الطريقة مع جميع عناصر الصفحة. لمعرفة عناصر الصفحة غير المتوافقة مع هذه الطريقة، يُرجى الرجوع إلى قيود تحديد الحجم والموضع.

المعلمات

الاسم	النوع	الوصف
ratio	Number	نسبة تغيير حجم ارتفاع عنصر الصفحة هذا.

الإرجاع

SpeakerSpotlight: عنصر الصفحة هذا، ويُستخدم في الربط.

التفويض

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

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

---

scaleWidth(ratio)

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

لا تتوافق هذه الطريقة مع جميع عناصر الصفحة. لمعرفة عناصر الصفحة غير المتوافقة مع هذه الطريقة، يُرجى الرجوع إلى قيود تحديد الحجم والموضع.

المعلمات

الاسم	النوع	الوصف
ratio	Number	نسبة تغيير حجم عرض عنصر الصفحة هذا.

الإرجاع

SpeakerSpotlight: عنصر الصفحة هذا، ويُستخدم في الربط.

التفويض

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

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

---

select()

يختار هذا الخيار PageElement فقط في العرض التقديمي النشط ويزيل أي اختيار سابق. وهذا الإجراء مماثل لاستدعاء select(replace) مع true.

لا يمكن للنص البرمجي الوصول إلى تحديد المستخدم الذي يشغّل النص البرمجي إلا إذا كان النص البرمجي مرتبطًا بالعرض التقديمي.

يؤدي هذا الإجراء إلى ضبط Page الأصل الخاص بـ PageElement على أنّه current page selection.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const pageElement = slide.getPageElements()[0];
// Only select this page element and replace any previous selection.
pageElement.select();

التفويض

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

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

---

select(replace)

يختار PageElement في العرض التقديمي النشط.

لا يمكن للنص البرمجي الوصول إلى تحديد المستخدم الذي يشغّل النص البرمجي إلا إذا كان النص البرمجي مرتبطًا بالعرض التقديمي.

مرِّر true إلى هذه الطريقة لاختيار PageElement فقط وإزالة أي اختيار سابق. يؤدي ذلك أيضًا إلى ضبط Page للعنصر الرئيسي PageElement على current page selection.

اضغط على false لتحديد عدة عناصر PageElement. يجب أن تكون عناصر PageElement في Page نفسها.

يجب استيفاء الشروط التالية عند اختيار عنصر صفحة باستخدام مَعلمة false:

1. يجب أن يكون العنصر الرئيسي Page للعنصر PageElement هو current page selection.
2. يجب عدم اختيار عناصر Page متعدّدة.

للتأكّد من ذلك، يُفضّل اختيار العنصر الأصل Page أولاً باستخدام Page.selectAsCurrentPage()، ثم اختيار عناصر الصفحة في تلك الصفحة.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// First select the slide page, as the current page selection.
slide.selectAsCurrentPage();
// Then select all the page elements in the selected slide page.
const pageElements = slide.getPageElements();
for (let i = 0; i < pageElements.length; i++) {
  pageElements[i].select(false);
}

المعلمات

الاسم	النوع	الوصف
replace	Boolean	إذا كانت القيمة true، سيحلّ الاختيار محل أي اختيار سابق، وإلا سيتم إضافة الاختيار إلى أي اختيار سابق.

التفويض

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

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

---

sendBackward()

يرسل عنصر الصفحة إلى الخلف بمقدار عنصر واحد.

يجب ألا يكون عنصر الصفحة في مجموعة.

الإرجاع

SpeakerSpotlight: عنصر الصفحة هذا، ويُستخدم في الربط.

التفويض

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

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

---

sendToBack()

يرسل عنصر الصفحة إلى خلف الصفحة.

يجب ألا يكون عنصر الصفحة في مجموعة.

الإرجاع

SpeakerSpotlight: عنصر الصفحة هذا، ويُستخدم في الربط.

التفويض

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

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

---

setDescription(description)

تضبط هذه السمة وصف النص البديل لعنصر الصفحة.

الطريقة غير متاحة لعناصر Group.

// Set the first page element's alt text description to "new alt text
// description".
const pageElement =
    SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setDescription('new alt text description');
Logger.log(pageElement.getDescription());

المعلمات

الاسم	النوع	الوصف
description	String	السلسلة التي سيتم ضبط وصف النص البديل عليها.

الإرجاع

SpeakerSpotlight: عنصر الصفحة هذا

التفويض

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

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

---

setHeight(height)

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

لا تتوافق هذه الطريقة مع جميع عناصر الصفحة. لمعرفة عناصر الصفحة غير المتوافقة مع هذه الطريقة، يُرجى الرجوع إلى قيود تحديد الحجم والموضع.

المعلمات

الاسم	النوع	الوصف
height	Number	تمثّل هذه السمة الارتفاع الجديد لعنصر الصفحة المطلوب ضبطه، ويتم قياسه بالنقاط.

الإرجاع

SpeakerSpotlight: عنصر الصفحة هذا، ويُستخدم في الربط.

التفويض

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

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

---

setLeft(left)

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

المعلمات

الاسم	النوع	الوصف
left	Number	الموضع الأفقي الجديد المطلوب ضبطه، بالنقاط

الإرجاع

SpeakerSpotlight: عنصر الصفحة هذا، ويُستخدم في الربط.

التفويض

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

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

---

setRotation(angle)

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

لا تتوافق هذه الطريقة مع جميع عناصر الصفحة. لمعرفة عناصر الصفحة غير المتوافقة مع هذه الطريقة، يُرجى الرجوع إلى قيود تحديد الحجم والموضع.

المعلمات

الاسم	النوع	الوصف
angle	Number	زاوية التدوير الجديدة في اتجاه عقارب الساعة المطلوب ضبطها، بالدرجات

الإرجاع

SpeakerSpotlight: عنصر الصفحة هذا، ويُستخدم في الربط.

التفويض

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

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

---

setTitle(title)

تضبط هذه السمة عنوان النص البديل لعنصر الصفحة.

الطريقة غير متاحة لعناصر Group.

// Set the first page element's alt text title to "new alt text title".
const pageElement =
    SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setTitle('new alt text title');
Logger.log(pageElement.getTitle());

المعلمات

الاسم	النوع	الوصف
title	String	السلسلة التي سيتم ضبط عنوان النص البديل عليها.

الإرجاع

SpeakerSpotlight: عنصر الصفحة هذا

التفويض

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

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

---

setTop(top)

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

المعلمات

الاسم	النوع	الوصف
top	Number	الموضع الرأسي الجديد الذي سيتم ضبطه، بالنقاط

الإرجاع

SpeakerSpotlight: عنصر الصفحة هذا، ويُستخدم في الربط.

التفويض

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

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

---

setTransform(transform)

تضبط هذه السمة تحويل عنصر الصفحة باستخدام التحويل المقدَّم.

يؤدي تعديل عملية التحويل لمجموعة إلى تغيير عملية التحويل المطلقة لعناصر الصفحة في تلك المجموعة، ما قد يؤدي إلى تغيير مظهرها المرئي.

عند تعديل تحويل عنصر صفحة موجود في مجموعة، يتم تغيير تحويل عنصر الصفحة هذا فقط، ولا يؤثر ذلك في تحويلات المجموعة أو عناصر الصفحة الأخرى في المجموعة.

للحصول على تفاصيل حول كيفية تأثير عمليات التحويل في المظهر المرئي لعناصر الصفحة، يُرجى الاطّلاع على getTransform().

المعلمات

الاسم	النوع	الوصف
transform	AffineTransform	تمثّل هذه السمة عملية التحويل التي تم ضبطها لعنصر الصفحة هذا.

الإرجاع

‫SpeakerSpotlight: هذا العنصر مخصّص للربط.

التفويض

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

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

---

setWidth(width)

تضبط هذه السمة عرض العنصر بالنقاط، وهو عرض المربّع المحيط بالعنصر عندما لا يكون العنصر مدوّرًا.

لا تتوافق هذه الطريقة مع جميع عناصر الصفحة. لمعرفة عناصر الصفحة غير المتوافقة مع هذه الطريقة، يُرجى الرجوع إلى قيود تحديد الحجم والموضع.

المعلمات

الاسم	النوع	الوصف
width	Number	تمثّل هذه السمة العرض الجديد لعنصر الصفحة المطلوب ضبطه، ويتم قياسه بالنقاط.

الإرجاع

SpeakerSpotlight: عنصر الصفحة هذا، ويُستخدم في الربط.

التفويض

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

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