تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class Image

تمثّل هذه الخاصية PageElement صورة.

الطُرق

الطريقة	نوع الإرجاع	وصف قصير
`alignOnPage(alignmentPosition)`	`Image`	لمحاذاة العنصر مع موضع المحاذاة المحدد في الصفحة.
`bringForward()`	`Image`	لجلب عنصر الصفحة للأمام على الصفحة بواسطة عنصر واحد.
`bringToFront()`	`Image`	لجلب عنصر الصفحة إلى مقدمة الصفحة.
`duplicate()`	`PageElement`	تكرار عنصر الصفحة.
`getAs(contentType)`	`Blob`	يمكنك عرض البيانات داخل هذا الكائن كائن ثنائي كبير (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)`

يمكنك عرض البيانات داخل هذا الكائن كائن ثنائي كبير (blob) تم تحويله إلى نوع المحتوى المحدد. تضيف هذه الطريقة الإضافة المناسبة إلى اسم الملف—على سبيل المثال، "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'` صالحًا أيضًا.

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

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 إذا لم يكن هناك رابط.

var link = shape.getLink();
if (link != null) {
  Logger.log('Shape has a link of type: ' + link.getLinkType());
}

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

Link

التفويض

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

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 نقطة:

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.

shape.removeLink();

`replace(blobSource)`

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

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

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

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

المعلَمات

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

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

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

التفويض

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

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

`replace(blobSource, crop)`

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

var image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0];
// Get the Drive image file with the given ID.
var driveImage = DriveApp.getFileById(fileId);
// 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 المقدّم عن 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.

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:

يجب أن يكون العنصر الرئيسي Page لكائن PageElement هو current page selection.
يجب ألا يكون هناك العديد من كائنات 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);
}

المعلَمات

الاسم	النوع	الوصف
`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".
var 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.
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.
var slide = presentation.getSlides()[0];
shape.setLinkSlide(slide);

المعلَمات

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