Class Image

صورة

PageElement يمثّل صورة

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
alignOnPage(alignmentPosition)	Image	محاذاة العنصر مع موضع المحاذاة المحدّد على الصفحة
bringForward()	Image	ينقل عنصر الصفحة إلى الأمام في الصفحة بعنصر واحد.
bringToFront()	Image	تنقل عنصر الصفحة إلى مقدمة الصفحة.
duplicate()	PageElement	تكرار عنصر الصفحة
getAs(contentType)	Blob	عرض البيانات داخل هذا العنصر كبيانات ثنائية كبيرة تم تحويلها إلى نوع المحتوى المحدّد
getBlob()	Blob	عرض البيانات داخل هذه الصورة ككتلة بيانات
getBorder()	Border	عرض Border للصورة
getConnectionSites()	ConnectionSite[]	تعرِض هذه السمة قائمة المواقع الإلكترونية التي ترتبط بها الصفحة، أو قائمة فارغة إذا لم يكن عنصر الصفحة يتضمّن أي مواقع إلكترونية مرتبطة.ConnectionSite
getContentUrl()	String	الحصول على عنوان URL للصورة
getDescription()	String	تعرِض هذه السمة وصف النص البديل لعنصر الصفحة.
getHeight()	Number	تحصل على ارتفاع العنصر بالنقاط، وهو ارتفاع مربّع حدود العنصر عندما لا يكون العنصر مُدرَجًا.
getInherentHeight()	Number	تعرِض هذه الدالة الارتفاع الأساسي للعنصر بالنقاط.
getInherentWidth()	Number	لعرض العرض الأساسي للعنصر بالنقاط.
getLeft()	Number	تعرِض هذه السمة موضع العنصر الأفقي بالنقاط، ويتم قياسه من أعلى يمين الصفحة عندما لا يكون العنصر مُدارًا.
getLink()	Link	تعرِض القيمة Link أو null في حال عدم توفّر رابط.
getObjectId()	String	تعرِض هذه السمة المعرّف الفريد لهذا العنصر.
getPageElementType()	PageElementType	لعرض نوع عنصر الصفحة، الذي يتم تمثيله كقائمة PageElementType.
getParentGroup()	Group	تعرِض هذه السمة المجموعة التي ينتمي إليها عنصر الصفحة، أو null إذا لم يكن العنصر في مجموعة.
getParentPage()	Page	تعرِض هذه السمة الصفحة التي يظهر عليها عنصر الصفحة.
getParentPlaceholder()	PageElement	تعرِض هذه السمة عنصر الصفحة الرئيسية للعنصر النائب.
getPlaceholderIndex()	Integer	لعرض فهرس صورة العنصر النائب.
getPlaceholderType()	PlaceholderType	تعرِض هذه السمة نوع العنصر النائب للصورة، أو PlaceholderType.NONE إذا لم يكن الشكل عنصرًا نائبًا.
getRotation()	Number	تعرض هذه الدالة زاوية دوران العنصر في اتجاه عقارب الساعة حول مركزه بالدرجات، حيث تعني درجة الصفر عدم التدوير.
getSourceUrl()	String	تحصل على عنوان URL لمصدر الصورة، إذا كان متاحًا.
getTitle()	String	عرض عنوان النص البديل لعنصر الصفحة
getTop()	Number	تحصل على موضع العنصر العمودي بالنقاط، ويتم قياسه من الزاوية العلوية اليسرى من الصفحة عندما لا يكون العنصر مُدارًا.
getTransform()	AffineTransform	لعرض تحويل عنصر الصفحة.
getWidth()	Number	تُعرِض هذه السمة عرض العنصر بالنقاط، وهو عرض مربّع حدود العنصر عندما لا يكون العنصر مُدرَجًا.
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)

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

المعلمات

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

الإرجاع

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 التي تم إنشاؤها حديثًا مؤقتًا لحدود قياسية أكثر صرامة.

المعلمات

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

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

الإرجاع

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

التفويض

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

• 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

---

getLink()

تعرِض القيمة 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: 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

التفويض

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

• 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 إذا لم تكن هذه الصورة عنصر نائب أو لم يكن لها عنصر رئيسي

التفويض

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

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

---

getPlaceholderIndex()

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

الإرجاع

Integer: فهرس العنصر النائب لهذه الصورة، أو 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: عنوان 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 إذا لم يكن لعنصر الصفحة عرض

التفويض

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

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

---

preconcatenateTransform(transform)

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

newTransform = argument * existingTransform;

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

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

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

المعلمات

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

الإرجاع

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

---

removeLink()

إزالة 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);

المعلمات

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

الإرجاع

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

المعلمات

الاسم	النوع	الوصف
blobSource	BlobSource	بيانات الصورة
crop	Boolean	إذا كان 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().

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

المعلمات

الاسم	النوع	الوصف
imageUrl	String	عنوان 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 كيلوبايت.

المعلمات

الاسم	النوع	الوصف
imageUrl	String	عنوان URL الذي يمكن تنزيل الصورة منه
crop	Boolean	إذا كان true، يتم اقتصاص الصورة لتتلاءم مع حجم الصورة الحالية. بخلاف ذلك، تتم تصغير الصورة ووضعها في المنتصف.

الإرجاع

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

التفويض

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

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

---

scaleHeight(ratio)

تُحوِّل هذه السمة ارتفاع العنصر إلى نسبة محدّدة. ارتفاع العنصر هو ارتفاع حدوده عندما لا يكون العنصر مُدرَجًا.

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

المعلمات

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

الإرجاع

Image: عنصر الصفحة هذا، لإنشاء سلسلة.

التفويض

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

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

---

scaleWidth(ratio)

تُحوِّل هذه السمة عرض العنصر إلى نسبة محدّدة. عرض العنصر هو عرض حدوده عندما لا يكون العنصر مُدرَجًا.

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

المعلمات

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

الإرجاع

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

المعلمات

الاسم	النوع	الوصف
replace	Boolean	إذا كان الخيار 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());

المعلمات

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

الإرجاع

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

التفويض

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

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

---

setHeight(height)

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

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

المعلمات

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

الإرجاع

Image: عنصر الصفحة هذا، لإنشاء سلسلة.

التفويض

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

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

---

setLeft(left)

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

المعلمات

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

الإرجاع

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

المعلمات

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

الإرجاع

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

المعلمات

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

المعلمات

الاسم	النوع	الوصف
slidePosition	SlidePosition	"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');

المعلمات

الاسم	النوع	الوصف
url	String	سلسلة عنوان URL

الإرجاع

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

التفويض

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

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

---

setRotation(angle)

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

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

المعلمات

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

الإرجاع

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

المعلمات

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

الإرجاع

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

التفويض

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

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

---

setTop(top)

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

المعلمات

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

الإرجاع

Image: عنصر الصفحة هذا، لإنشاء سلسلة.

التفويض

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

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

---

setTransform(transform)

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

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

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

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

المعلمات

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

الإرجاع

Image: هذا العنصر مخصّص للتسلسل.

التفويض

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

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

---

setWidth(width)

تُستخدَم لضبط عرض العنصر بالنقاط، وهو عرض مربّع حدود العنصر عندما لا يكون العنصر مُدرَجًا.

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

المعلمات

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

الإرجاع

Image: عنصر الصفحة هذا، لإنشاء سلسلة.

التفويض

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

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