Class Image

صورة

PageElement يمثّل صورة

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
alignOnPage(alignmentPosition)Imageتعمل هذه السمة على محاذاة العنصر مع موضع المحاذاة المحدّد على الصفحة.
bringForward()Imageيقدّم عنصر الصفحة إلى الأمام على الصفحة بمقدار عنصر واحد.
bringToFront()Imageيتم عرض عنصر الصفحة في مقدّمة الصفحة.
duplicate()PageElementتكرِّر هذه السمة عنصر الصفحة.
getAs(contentType)Blobلعرض البيانات داخل هذا العنصر ككائن ثنائي كبير تم تحويله إلى نوع المحتوى المحدّد
getBlob()Blobعرض البيانات داخل هذه الصورة ككائن ثنائي كبير
getBorder()Borderتعرض هذه السمة Border الخاصة بالصورة.
getConnectionSites()ConnectionSite[]تعرض هذه السمة قائمة ConnectionSites في عنصر الصفحة، أو قائمة فارغة إذا كان عنصر الصفحة لا يتضمّن أي مواقع إلكترونية مرتبطة.
getContentUrl()Stringتعرض هذه السمة عنوان URL للصورة.
getDescription()Stringتعرض هذه السمة وصف النص البديل لعنصر الصفحة.
getHeight()Number|nullتعرض هذه السمة ارتفاع العنصر بالنقاط، وهو ارتفاع المربّع المحيط بالعنصر عندما لا يكون العنصر مدوّرًا.
getInherentHeight()Number|nullتعرض هذه السمة الارتفاع المتأصّل للعنصر بالنقاط.
getInherentWidth()Number|nullتعرض هذه السمة العرض المضمّن للعنصر بالنقاط.
getLeft()Numberتعرض هذه السمة الموضع الأفقي للعنصر بالنقاط، ويتم قياسه من الزاوية العلوية اليمنى من الصفحة عندما لا يكون العنصر في وضع تدوير.
getLink()Link|nullتعرِض Link أو null إذا لم يكن هناك رابط.
getObjectId()Stringتعرض هذه الطريقة المعرّف الفريد لهذا العنصر.
getPageElementType()PageElementTypeتعرض هذه السمة نوع عنصر الصفحة، ويتم تمثيله كقيمة تعداد PageElementType.
getParentGroup()Group|nullتعرض هذه السمة المجموعة التي ينتمي إليها عنصر الصفحة، أو null إذا لم يكن العنصر في مجموعة.
getParentPage()Pageتعرض هذه السمة الصفحة التي يظهر عليها عنصر الصفحة هذا.
getParentPlaceholder()PageElement|nullتعرض هذه السمة عنصر الصفحة الرئيسية للعنصر النائب.
getPlaceholderIndex()Integer|nullتعرض هذه السمة فهرس الصورة النائبة.
getPlaceholderType()PlaceholderTypeتعرض هذه السمة نوع العنصر النائب للصورة، أو PlaceholderType.NONE إذا لم يكن الشكل عنصرًا نائبًا.
getRotation()Numberتعرض هذه السمة زاوية تدوير العنصر في اتجاه عقارب الساعة حول مركزه بالدرجات، حيث تعني الدرجة صفر عدم التدوير.
getSourceUrl()String|nullتعرض هذه السمة عنوان URL لمصدر الصورة، إذا كان متاحًا.
getTitle()Stringتعرض هذه السمة عنوان النص البديل لعنصر الصفحة.
getTop()Numberتعرض هذه السمة الموضع العمودي للعنصر بالنقاط، ويتم قياسه من الزاوية العلوية اليسرى للصفحة عندما لا يكون العنصر في وضع تدوير.
getTransform()AffineTransformتعرض هذه السمة تحويل عنصر الصفحة.
getWidth()Number|nullتعرض هذه السمة عرض العنصر بالنقاط، وهو عرض المربّع المحيط بالعنصر عندما لا يكون العنصر مدوّرًا.
preconcatenateTransform(transform)Imageيتم دمج عملية التحويل المقدَّمة مع عملية التحويل الحالية لعنصر الصفحة.
remove()voidتزيل هذه الطريقة عنصر الصفحة.
removeLink()voidتزيل هذه الطريقة Link.
replace(blobSource)Imageيستبدل هذه الصورة بصورة موصوفة بواسطة عنصر BlobSource.
replace(blobSource, crop)Imageيستبدل هذه الصورة بصورة موصوفة بواسطة عنصر Image، مع إمكانية اقتصاص الصورة لتناسب المساحة.
replace(imageUrl)Imageيستبدل هذه الصورة بصورة أخرى تم تنزيلها من عنوان URL المقدَّم.
replace(imageUrl, crop)Imageيستبدل هذه الصورة بصورة أخرى تم تنزيلها من عنوان URL المقدَّم، ويمكنه اقتصاص الصورة لتناسب المساحة المحدّدة.
scaleHeight(ratio)Imageتغيّر حجم ارتفاع العنصر حسب النسبة المحدّدة.
scaleWidth(ratio)Imageتغيّر حجم عرض العنصر حسب النسبة المحدّدة.
select()voidيحدّد هذا الخيار PageElement في العرض التقديمي النشط فقط ويزيل أي تحديد سابق.
select(replace)voidيختار هذا الخيار PageElement في العرض التقديمي النشط.
sendBackward()Imageيرسل عنصر الصفحة إلى الخلف بمقدار عنصر واحد.
sendToBack()Imageيرسل عنصر الصفحة إلى خلف الصفحة.
setDescription(description)Imageتضبط هذه السمة وصف النص البديل لعنصر الصفحة.
setHeight(height)Imageتضبط هذه السمة ارتفاع العنصر بالنقاط، وهو ارتفاع المربّع المحيط بالعنصر عندما لا يكون العنصر مدوّرًا.
setLeft(left)Imageتضبط هذه السمة الموضع الأفقي للعنصر بالنقاط، ويتم قياسه من الزاوية العلوية اليمنى للصفحة عندما لا يكون العنصر في وضع تدوير.
setLinkSlide(slideIndex)Linkيضبط Link على Slide المحدّد باستخدام الفهرس المستند إلى الصفر للشريحة.
setLinkSlide(slide)Linkيضبط Link على Slide المحدّد، ويتم ضبط الرابط حسب معرّف الشريحة المحدّد.
setLinkSlide(slidePosition)Linkيضبط Link على Slide المحدّد باستخدام الموضع النسبي للشريحة.
setLinkUrl(url)Linkتضبط هذه السمة Link على سلسلة عنوان URL غير فارغة.
setRotation(angle)Imageتضبط هذه السمة زاوية تدوير العنصر في اتجاه عقارب الساعة حول مركزه بالدرجات.
setTitle(title)Imageتضبط هذه السمة عنوان النص البديل لعنصر الصفحة.
setTop(top)Imageتضبط هذه السمة الموضع العمودي للعنصر بالنقاط، ويتم قياسه من الزاوية العلوية اليسرى للصفحة عندما لا يكون العنصر مدوّرًا.
setTransform(transform)Imageتضبط هذه السمة تحويل عنصر الصفحة باستخدام التحويل المقدَّم.
setWidth(width)Imageتضبط هذه السمة عرض العنصر بالنقاط، وهو عرض المربّع المحيط بالعنصر عندما لا يكون العنصر مدوّرًا.

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

alignOnPage(alignmentPosition)

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

المعلمات

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

الإرجاع

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

bringForward()

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

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

الإرجاع

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

التفويض

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

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

bringToFront()

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

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

الإرجاع

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

التفويض

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

  • 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

getAs(contentType)

لعرض البيانات داخل هذا العنصر ككائن ثنائي كبير تم تحويله إلى نوع المحتوى المحدّد تضيف هذه الطريقة الامتداد المناسب إلى اسم الملف، مثل "myfile.pdf". ومع ذلك، يفترض هذا الخيار أنّ الجزء من اسم الملف الذي يلي النقطة الأخيرة (إن وُجدت) هو امتداد حالي يجب استبداله. نتيجةً لذلك، يصبح اسم الملف "ShoppingList.12.25.2014" هو "ShoppingList.12.25.pdf".

للاطّلاع على الحصص اليومية للإحالات الناجحة، يُرجى الاطّلاع على حصص خدمات Google. قد تخضع نطاقات Google Workspace التي تم إنشاؤها حديثًا لحصص أكثر صرامة بشكل مؤقت.

المعلمات

الاسمالنوعالوصف
contentTypeStringنوع MIME الذي سيتم التحويل إليه. بالنسبة إلى معظم الكائنات الثنائية الكبيرة، 'application/pdf' هو الخيار الصالح الوحيد. بالنسبة إلى الصور بتنسيق BMP أو GIF أو JPEG أو PNG، يمكن استخدام أي من 'image/bmp' أو 'image/gif' أو 'image/jpeg' أو 'image/png'. بالنسبة إلى مستند Google، يكون 'text/markdown' صالحًا أيضًا.

الإرجاع

Blob: البيانات ككائن ثنائي كبير.

getBlob()

عرض البيانات داخل هذه الصورة ككائن ثنائي كبير

الإرجاع

Blob: بيانات الصورة ككائن ثنائي كبير.

getBorder()

تعرض هذه السمة Border الخاصة بالصورة.

الإرجاع

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

getContentUrl()

تعرض هذه السمة عنوان URL للصورة.

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

الإرجاع

String

التفويض

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

  • 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

تعرِض Link أو null إذا لم يكن هناك رابط. 

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const link = shape.getLink();
if (link != null) {
  Logger.log(`Shape has a link of type: ${link.getLinkType()}`);
}

الإرجاع

Link|null: Link أو 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

getParentPlaceholder()

تعرض هذه السمة عنصر الصفحة الرئيسية للعنصر النائب. تعرِض null إذا لم تكن الصورة عنصرًا نائبًا أو لم يكن لها عنصر رئيسي.

الإرجاع

‫PageElement|null: عنصر الصفحة الرئيسي الذي يمثّل عنصر نائب لهذه الصورة، أو null إذا لم تكن هذه الصورة عنصرًا نائبًا أو لم يكن لها عنصر رئيسي.

التفويض

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

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

getPlaceholderIndex()

تعرض هذه السمة فهرس الصورة النائبة. إذا كان هناك صورتان أو أكثر من الصور النائبة على الصفحة نفسها من النوع نفسه، سيكون لكل منها قيمة فهرس فريدة. تعرِض null إذا لم تكن الصورة عنصرًا نائبًا.

الإرجاع

Integer|null: فهرس العنصر النائب لهذه الصورة، أو null إذا لم تكن الصورة عنصرًا نائبًا

التفويض

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

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

getPlaceholderType()

تعرض هذه السمة نوع العنصر النائب للصورة، أو PlaceholderType.NONE إذا لم يكن الشكل عنصرًا نائبًا.

الإرجاع

‫PlaceholderType: تمثّل نوع العنصر النائب لهذه الصورة.

التفويض

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

  • 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

getSourceUrl()

تعرض هذه السمة عنوان URL لمصدر الصورة، إذا كان متاحًا.

عند إدراج صورة بواسطة عنوان URL، تعرض هذه السمة عنوان URL المقدَّم أثناء إدراج الصورة.

الإرجاع

String|null: عنوان URL للصورة أو null إذا لم يكن للصورة عنوان URL مصدر.

التفويض

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

  • 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التحويل إلى عملية ربط مسبقة بعنصر الصفحة هذا.

الإرجاع

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

التفويض

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

  • 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

تزيل هذه الطريقة Link. 

const slides = SlidesApp.getActivePresentation().getSlides();
slides[1].getShapes()[0].removeLink();

replace(blobSource)

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

عند إدراج الصورة، يتم جلبها من BlobSource مرة واحدة ويتم تخزين نسخة منها لعرضها داخل العرض التقديمي. يجب أن يكون حجم الصور أقل من 50 ميغابايت، وألا تتجاوز 25 ميغابكسل، وأن تكون بتنسيق PNG أو JPEG أو GIF.

للحفاظ على نسبة العرض إلى الارتفاع للصورة، يتم تغيير حجم الصورة وتوسيطها بالنسبة إلى حجم الصورة الحالية. 

const image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0];
// Get the Drive image file with the given ID.
const driveImage = DriveApp.getFileById("123abc");
image.replace(driveImage);

المعلمات

الاسمالنوعالوصف
blobSourceBlobSourceبيانات الصورة

الإرجاع

Image: هذا Image بعد الاستبدال.

التفويض

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

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

replace(blobSource, crop)

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

عند إدراج الصورة، يتم جلبها من BlobSource مرة واحدة ويتم تخزين نسخة منها لعرضها داخل العرض التقديمي. يجب أن يكون حجم الصور أقل من 50 ميغابايت، وألا تتجاوز 25 ميغابكسل، وأن تكون بتنسيق PNG أو JPEG أو GIF. 

const image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0];
// Get the Drive image file with the given ID.
const driveImage = DriveApp.getFileById('123abc');
// Replace and crop the drive image.
image.replace(driveImage, true);

المعلمات

الاسمالنوعالوصف
blobSourceBlobSourceبيانات الصورة
cropBooleanإذا كانت القيمة true، يتم اقتصاص الصورة لتتلاءم مع حجم الصورة الحالية. وإلا، يتم تغيير حجم الصورة وتوسيطها.

الإرجاع

Image: هذا Image بعد الاستبدال.

التفويض

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

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

replace(imageUrl)

يستبدل هذه الصورة بصورة أخرى تم تنزيلها من عنوان URL المقدَّم.

عند إدراج الصورة، يتم جلبها من عنوان URL مرة واحدة ويتم تخزين نسخة منها لعرضها داخل العرض التقديمي. يجب أن يكون حجم الصور أقل من 50 ميغابايت، وألا تتجاوز 25 ميغابكسل، وأن تكون بتنسيق PNG أو JPEG أو GIF.

يجب أن يكون عنوان URL المقدَّم متاحًا للجميع وألا يتجاوز حجمه 2 كيلوبايت. يتم حفظ عنوان URL نفسه مع الصورة وعرضه من خلال getSourceUrl().

للحفاظ على نسبة العرض إلى الارتفاع للصورة، يتم تغيير حجم الصورة وتوسيطها بالنسبة إلى حجم الصورة الحالية.

المعلمات

الاسمالنوعالوصف
imageUrlStringتمثّل هذه السمة عنوان URL الذي يمكن تنزيل الصورة منه.

الإرجاع

Image: هذا Image بعد الاستبدال.

التفويض

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

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

replace(imageUrl, crop)

يستبدل هذه الصورة بصورة أخرى تم تنزيلها من عنوان URL المقدَّم، ويمكنه اقتصاص الصورة لتناسب المساحة المحدّدة.

عند إدراج الصورة، يتم جلبها من عنوان URL مرة واحدة ويتم تخزين نسخة منها لعرضها داخل العرض التقديمي. يجب أن يكون حجم الصور أقل من 50 ميغابايت، وألا تتجاوز 25 ميغابكسل، وأن تكون بتنسيق PNG أو JPEG أو GIF.

يجب ألا يتجاوز حجم عنوان URL المقدَّم 2 كيلوبايت.

المعلمات

الاسمالنوعالوصف
imageUrlStringتمثّل هذه السمة عنوان URL الذي يمكن تنزيل الصورة منه.
cropBooleanإذا كانت القيمة true، يتم اقتصاص الصورة لتتلاءم مع حجم الصورة الحالية. وإلا، يتم تغيير حجم الصورة وتوسيطها.

الإرجاع

Image: هذا Image بعد الاستبدال.

التفويض

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

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

scaleHeight(ratio)

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

scaleWidth(ratio)

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

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

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

الإرجاع

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

التفويض

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

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

sendToBack()

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

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

الإرجاع

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

التفويض

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

  • 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السلسلة التي سيتم ضبط وصف النص البديل عليها.

الإرجاع

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

التفويض

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

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

setHeight(height)

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

setLeft(left)

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

المعلمات

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

الإرجاع

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

التفويض

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

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

setLinkSlide(slideIndex)

يضبط Link على Slide المحدّد باستخدام الفهرس المستند إلى الصفر للشريحة. 

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(0);

المعلمات

الاسمالنوعالوصف
slideIndexIntegerالفهرس الذي يبدأ من 0 للشريحة

الإرجاع

‫Link: Link الذي تم ضبطه

التفويض

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

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

setLinkSlide(slide)

يضبط Link على Slide المحدّد، ويتم ضبط الرابط حسب معرّف الشريحة المحدّد. 

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(slides[0]);

المعلمات

الاسمالنوعالوصف
slideSlideتمثّل Slide الحساب المطلوب ربطه.

الإرجاع

‫Link: Link الذي تم ضبطه

التفويض

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

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

setLinkSlide(slidePosition)

يضبط Link على Slide المحدّد باستخدام الموضع النسبي للشريحة. 

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);

المعلمات

الاسمالنوعالوصف
slidePositionSlidePositionتمثّل هذه السمة SlidePosition النسبي.

الإرجاع

‫Link: Link الذي تم ضبطه

التفويض

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

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

setLinkUrl(url)

تضبط هذه السمة Link على سلسلة عنوان URL غير فارغة. 

// Set a link to the URL.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkUrl('https://slides.google.com');

المعلمات

الاسمالنوعالوصف
urlStringسلسلة عنوان URL

الإرجاع

‫Link: Link الذي تم ضبطه

التفويض

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

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

setRotation(angle)

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

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

المعلمات

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

الإرجاع

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

التفويض

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

  • 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السلسلة التي سيتم ضبط عنوان النص البديل عليها.

الإرجاع

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

التفويض

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

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

setTop(top)

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

المعلمات

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

الإرجاع

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

التفويض

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

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

setTransform(transform)

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

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

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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

setWidth(width)

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

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

المعلمات

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

الإرجاع

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

التفويض

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

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