Class PageElement

PageElement

عنصر مرئي يتم عرضه على صفحة

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
alignOnPage(alignmentPosition)PageElementتعمل هذه السمة على محاذاة العنصر مع موضع المحاذاة المحدّد على الصفحة.
asGroup()Groupتعرض هذه السمة عنصر الصفحة كمجموعة.
asImage()Imageتعرض هذه السمة عنصر الصفحة كصورة.
asLine()Lineتعرض هذه السمة عنصر الصفحة كخط.
asShape()Shapeتعرض هذه السمة عنصر الصفحة كشكل.
asSheetsChart()SheetsChartتعرض هذه السمة عنصر الصفحة كرسم بياني مرتبط مضمّن من "جداول بيانات Google".
asSpeakerSpotlight()SpeakerSpotlightتعرض هذه السمة عنصر الصفحة كفقرة تمييز للمتحدث.
asTable()Tableتعرض هذه السمة عنصر الصفحة كجدول.
asVideo()Videoتعرض هذه السمة عنصر الصفحة كفيديو.
asWordArt()WordArtتعرض هذه السمة عنصر الصفحة كعمل فني باستخدام الخطوط.
bringForward()PageElementيقدّم عنصر الصفحة إلى الأمام على الصفحة بمقدار عنصر واحد.
bringToFront()PageElementيتم عرض عنصر الصفحة في مقدّمة الصفحة.
duplicate()PageElementتكرِّر هذه السمة عنصر الصفحة.
getConnectionSites()ConnectionSite[]تعرض هذه السمة قائمة ConnectionSites في عنصر الصفحة، أو قائمة فارغة إذا كان عنصر الصفحة لا يتضمّن أي مواقع إلكترونية مرتبطة.
getDescription()Stringتعرض هذه السمة وصف النص البديل لعنصر الصفحة.
getHeight()Number|nullتعرض هذه السمة ارتفاع العنصر بالنقاط، وهو ارتفاع المربّع المحيط بالعنصر عندما لا يكون العنصر مدوّرًا.
getInherentHeight()Number|nullتعرض هذه السمة الارتفاع المتأصّل للعنصر بالنقاط.
getInherentWidth()Number|nullتعرض هذه السمة العرض المضمّن للعنصر بالنقاط.
getLeft()Numberتعرض هذه السمة الموضع الأفقي للعنصر بالنقاط، ويتم قياسه من الزاوية العلوية اليمنى من الصفحة عندما لا يكون العنصر في وضع تدوير.
getObjectId()Stringتعرض هذه الطريقة المعرّف الفريد لهذا العنصر.
getPageElementType()PageElementTypeتعرض هذه السمة نوع عنصر الصفحة، ويتم تمثيله كقيمة تعداد PageElementType.
getParentGroup()Group|nullتعرض هذه السمة المجموعة التي ينتمي إليها عنصر الصفحة، أو null إذا لم يكن العنصر في مجموعة.
getParentPage()Pageتعرض هذه السمة الصفحة التي يظهر عليها عنصر الصفحة هذا.
getRotation()Numberتعرض هذه السمة زاوية تدوير العنصر في اتجاه عقارب الساعة حول مركزه بالدرجات، حيث تعني الدرجة صفر عدم التدوير.
getTitle()Stringتعرض هذه السمة عنوان النص البديل لعنصر الصفحة.
getTop()Numberتعرض هذه السمة الموضع العمودي للعنصر بالنقاط، ويتم قياسه من الزاوية العلوية اليسرى للصفحة عندما لا يكون العنصر في وضع تدوير.
getTransform()AffineTransformتعرض هذه السمة تحويل عنصر الصفحة.
getWidth()Number|nullتعرض هذه السمة عرض العنصر بالنقاط، وهو عرض المربّع المحيط بالعنصر عندما لا يكون العنصر مدوّرًا.
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)

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

المعلمات

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

الإرجاع

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

asSpeakerSpotlight()

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

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const pageElement = slide.getPageElements()[0];
pageElement.asSpeakerSpotlight();

الإرجاع

‫SpeakerSpotlight: عنصر الصفحة كفيديو مضمَّن للمُحاضِر

التفويض

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

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

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

الإرجاع

WordArt: يمثّل هذا العنصر في الصفحة فن الكلمات.

التفويض

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

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

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

المعلمات

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

الإرجاع

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)

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

scaleWidth(ratio)

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

المعلمات

الاسمالنوعالوصف
replaceBooleanإذا كانت القيمة 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".
const pageElement =
    SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setDescription('new alt text description');
Logger.log(pageElement.getDescription());

المعلمات

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

الإرجاع

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

التفويض

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

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

setHeight(height)

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

setLeft(left)

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

المعلمات

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

الإرجاع

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

التفويض

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

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

setRotation(angle)

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

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

المعلمات

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

الإرجاع

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

المعلمات

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

الإرجاع

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

التفويض

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

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

setTop(top)

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

المعلمات

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

الإرجاع

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

التفويض

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

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

setTransform(transform)

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

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

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

setWidth(width)

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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