Class PageElement

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

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

الطُرق

الطريقةنوع الإرجاعوصف قصير
alignOnPage(alignmentPosition)PageElementلمحاذاة العنصر مع موضع المحاذاة المحدد في الصفحة.
asGroup()Groupلعرض عنصر الصفحة كمجموعة.
asImage()Imageلعرض عنصر الصفحة كصورة.
asLine()Lineلعرض عنصر الصفحة كسطر.
asShape()Shapeلعرض عنصر الصفحة كشكل.
asSheetsChart()SheetsChartلعرض عنصر الصفحة كمخطط مرتبط مضمن من جداول بيانات Google.
asTable()Tableلعرض عنصر الصفحة كجدول.
asVideo()Videoلعرض عنصر الصفحة كفيديو.
asWordArt()WordArtلعرض عنصر الصفحة كصورة فنية.
bringForward()PageElementلجلب عنصر الصفحة للأمام على الصفحة بواسطة عنصر واحد.
bringToFront()PageElementلجلب عنصر الصفحة إلى مقدمة الصفحة.
duplicate()PageElementتكرار عنصر الصفحة.
getConnectionSites()ConnectionSite[]لعرض قائمة من ConnectionSite في عنصر الصفحة، أو قائمة فارغة إذا لم يكن عنصر الصفحة يحتوي على أي مواقع اتصال.
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)

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

المَعلمات

الاسمالنوعالوصف
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

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 — عنصر الصفحة هذا في صورة 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()

لعرض قائمة من ConnectionSite في عنصر الصفحة، أو قائمة فارغة إذا لم يكن عنصر الصفحة يحتوي على أي مواقع اتصال.

تذكرة ذهاب وعودة

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

المَعلمات

الاسمالنوعالوصف
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.

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

المَعلمات

الاسمالنوعالوصف
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".
var 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".
var 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