Class PageElement

PageElement

يشير ذلك المصطلح إلى عنصر مرئي يتم عرضه على صفحة.

الطُرق

الطريقة	نوع القيمة التي يتم إرجاعها	وصف قصير
alignOnPage(alignmentPosition)	PageElement	لمحاذاة العنصر مع موضع المحاذاة المحدد على الصفحة
asGroup()	Group	لعرض عنصر الصفحة كمجموعة.
asImage()	Image	لعرض عنصر الصفحة كصورة.
asLine()	Line	لعرض عنصر الصفحة كسطر.
asShape()	Shape	تعرض عنصر الصفحة على هيئة شكل.
asSheetsChart()	SheetsChart	لعرض عنصر الصفحة كمخطط مرتبط مضمّن من "جداول بيانات Google".
asTable()	Table	لعرض عنصر الصفحة على شكل جدول.
asVideo()	Video	لعرض عنصر الصفحة كفيديو.
asWordArt()	WordArt	لعرض عنصر الصفحة على هيئة word Art.
bringForward()	PageElement	لإحضار عنصر الصفحة إلى الأمام على الصفحة بمقدار عنصر واحد.
bringToFront()	PageElement	لإحضار عنصر الصفحة إلى مقدمة الصفحة.
duplicate()	PageElement	يكرّر عنصر الصفحة.
getConnectionSites()	ConnectionSite[]	عرض قائمة ConnectionSites على عنصر الصفحة، أو عرض قائمة فارغة إذا لم يكن عنصر الصفحة يحتوي على أي مواقع ربط.
getDescription()	String	لعرض وصف النص البديل لعنصر الصفحة.
getHeight()	Number	للحصول على ارتفاع العنصر بالنقاط، وهو ارتفاع مربّع إحاطة العنصر عندما لا يكون له دوران.
getInherentHeight()	Number	لعرض الارتفاع المتأصل في العنصر بالنقاط.
getInherentWidth()	Number	لعرض العرض المتأصل للعنصر بالنقاط.
getLeft()	Number	يتم عرض الموضع الأفقي للعنصر بالنقاط، ويتم قياسه من الزاوية العلوية اليسرى للصفحة عندما لا يكون للعنصر دوران.
getObjectId()	String	يعرض المُعرّف الفريد لهذا العنصر.
getPageElementType()	PageElementType	لعرض نوع عنصر الصفحة، ويتم تمثيله بالتعداد PageElementType.
getParentGroup()	Group	لعرض المجموعة التي ينتمي إليها عنصر الصفحة هذا أو null إذا لم يكن العنصر في مجموعة.
getParentPage()	Page	لعرض الصفحة التي يوجد بها عنصر الصفحة هذا.
getRotation()	Number	يتم عرض زاوية الدوران في اتجاه عقارب الساعة للعنصر حول مركزه بالدرجات، حيث تعني الدرجة صفر عدم الدوران.
getTitle()	String	لعرض عنوان النص البديل لعنصر الصفحة.
getTop()	Number	للحصول على الموضع الرأسي للعنصر بالنقاط، يتم قياسه من الزاوية العلوية اليسرى للصفحة عندما لا يكون للعنصر دوران.
getTransform()	AffineTransform	لعرض تحويل عنصر الصفحة.
getWidth()	Number	لعرض عرض العنصر بالنقاط، وهو عرض مربع إحاطة العنصر عندما لا يكون له دوران.
preconcatenateTransform(transform)	PageElement	يربط التحويل المقدم مسبقًا بالتحويل الحالي لعنصر الصفحة.
remove()	void	لإزالة عنصر الصفحة.
scaleHeight(ratio)	PageElement	لتحجيم ارتفاع العنصر حسب النسبة المحددة.
scaleWidth(ratio)	PageElement	لتحجيم عرض العنصر حسب النسبة المحددة.
select()	void	اختيار PageElement فقط في العرض التقديمي النشط وإزالة أي اختيار سابق
select(replace)	void	لاختيار PageElement في العرض التقديمي النشط.
sendBackward()	PageElement	لإعادة عنصر الصفحة إلى الخلف على الصفحة بواسطة عنصر واحد.
sendToBack()	PageElement	لإرسال عنصر الصفحة إلى الجزء الخلفي من الصفحة.
setDescription(description)	PageElement	لضبط وصف النص البديل لعنصر الصفحة.
setHeight(height)	PageElement	لتعيين ارتفاع العنصر بالنقاط، وهو ارتفاع مربع إحاطة العنصر عندما لا يكون له دوران.
setLeft(left)	PageElement	لتحديد الموضع الأفقي للعنصر بالنقاط، ويتم قياسه من الزاوية العلوية اليسرى للصفحة عندما لا يكون للعنصر أي دوران.
setRotation(angle)	PageElement	لضبط زاوية تدوير العنصر في اتجاه عقارب الساعة حول مركزه بالدرجات.
setTitle(title)	PageElement	لضبط عنوان النص البديل لعنصر الصفحة.
setTop(top)	PageElement	لضبط الموضع الرأسي للعنصر بالنقاط، يتم قياسه من الزاوية العلوية اليسرى للصفحة عندما لا يكون للعنصر دوران.
setTransform(transform)	PageElement	لضبط تحويل عنصر الصفحة مع التحويل المقدم.
setWidth(width)	PageElement	لتعيين عرض العنصر بالنقاط، وهو عرض مربع إحاطة العنصر عندما لا يكون للعنصر دوران.

الوثائق التفصيلية

alignOnPage(alignmentPosition)

لمحاذاة العنصر مع موضع المحاذاة المحدد على الصفحة

المَعلمات

الاسم	Type	الوصف
alignmentPosition	AlignmentPosition	موضع محاذاة عنصر الصفحة هذا مع الصفحة.

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

PageElement - عنصر الصفحة هذا للسلاسل

---

asGroup()

لعرض عنصر الصفحة كمجموعة.

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

Group - عنصر الصفحة هذا كمجموعة.

التفويض

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

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

---

asImage()

لعرض عنصر الصفحة كصورة.

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

Image - عنصر الصفحة هذا كصورة

التفويض

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

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

---

asLine()

لعرض عنصر الصفحة كسطر.

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

Line - عنصر الصفحة هذا على هيئة سطر.

التفويض

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

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

---

asShape()

تعرض عنصر الصفحة على هيئة شكل.

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

Shape - عنصر الصفحة هذا على شكل شكل.

التفويض

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

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

---

asSheetsChart()

لعرض عنصر الصفحة كمخطط مرتبط مضمّن من "جداول بيانات Google".

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

SheetsChart - عنصر الصفحة على شكل رسم بياني

التفويض

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

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

---

asTable()

لعرض عنصر الصفحة على شكل جدول.

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

Table — عنصر الصفحة هذا على شكل جدول.

التفويض

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

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

---

asVideo()

لعرض عنصر الصفحة كفيديو.

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

Video - عنصر الصفحة هذا كفيديو

التفويض

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

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

---

asWordArt()

لعرض عنصر الصفحة على هيئة word Art.

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

WordArt - عنصر الصفحة هذا هو word Art.

التفويض

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

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

---

bringForward()

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

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

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

PageElement - عنصر الصفحة هذا للسلاسل

التفويض

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

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

---

bringToFront()

لإحضار عنصر الصفحة إلى مقدمة الصفحة.

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

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

PageElement - عنصر الصفحة هذا للسلاسل

التفويض

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

• 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

---

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 إذا لم يكن لعنصر الصفحة ارتفاع.

التفويض

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

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

---

getInherentHeight()

لعرض الارتفاع المتأصل في العنصر بالنقاط.

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

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

Number — الارتفاع الأصلي لعنصر الصفحة بالنقاط أو null إذا لم يكن لعنصر الصفحة ارتفاع.

التفويض

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

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

---

getInherentWidth()

لعرض العرض المتأصل للعنصر بالنقاط.

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

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

Number: العرض المتأصل في عنصر الصفحة بالنقاط، أو 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

---

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.

التفويض

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

• 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 إذا لم يكن لعنصر الصفحة عرضًا.

التفويض

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

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

---

preconcatenateTransform(transform)

يربط التحويل المقدم مسبقًا بالتحويل الحالي لعنصر الصفحة.

newTransform = argument * existingTransform

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

element.preconcatenateTransform(SlidesApp.newAffineTransformBuilder()
    .setTranslateX(-36.0)
    .build());

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

المَعلمات

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

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

PageElement - عنصر الصفحة هذا للسلاسل

التفويض

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

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

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

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

المَعلمات

الاسم	Type	الوصف
ratio	Number	النسبة المستخدَمة لقياس ارتفاع عنصر الصفحة هذا.

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

PageElement - عنصر الصفحة هذا للسلاسل

التفويض

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

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

---

scaleWidth(ratio)

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

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

المَعلمات

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

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

PageElement - عنصر الصفحة هذا للسلاسل

التفويض

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

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

---

select()

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

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

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

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var 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() أولاً، ثم اختيار عناصر الصفحة في تلك الصفحة.

var 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.
var pageElements = slide.getPageElements();
for (var i = 0; i < pageElements.length; i++) {
  pageElements[i].select(false);
}

المَعلمات

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

التفويض

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

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

---

sendBackward()

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

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

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

PageElement - عنصر الصفحة هذا للسلاسل

التفويض

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

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

---

sendToBack()

لإرسال عنصر الصفحة إلى الجزء الخلفي من الصفحة.

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

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

PageElement - عنصر الصفحة هذا للسلاسل

التفويض

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

• 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".
var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setDescription('new alt text description');
Logger.log(pageElement.getDescription());

المَعلمات

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

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

PageElement — عنصر الصفحة هذا

التفويض

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

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

---

setHeight(height)

لتعيين ارتفاع العنصر بالنقاط، وهو ارتفاع مربع إحاطة العنصر عندما لا يكون له دوران.

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

المَعلمات

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

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

PageElement - عنصر الصفحة هذا للسلاسل

التفويض

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

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

---

setLeft(left)

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

المَعلمات

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

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

PageElement - عنصر الصفحة هذا للسلاسل

التفويض

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

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

---

setRotation(angle)

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

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

المَعلمات

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

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

PageElement - عنصر الصفحة هذا للسلاسل

التفويض

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

• 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".
var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setTitle('new alt text title');
Logger.log(pageElement.getTitle());

المَعلمات

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

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

PageElement — عنصر الصفحة هذا

التفويض

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

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

---

setTop(top)

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

المَعلمات

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

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

PageElement - عنصر الصفحة هذا للسلاسل

التفويض

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

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

---

setTransform(transform)

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

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

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

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

المَعلمات

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

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

PageElement: هذا العنصر للسلاسل

التفويض

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

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

---

setWidth(width)

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

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

المَعلمات

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

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

PageElement - عنصر الصفحة هذا للسلاسل

التفويض

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

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