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

Class Image

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

الطُرق

الطريقة	نوع القيمة التي يتم إرجاعها	وصف قصير
`alignOnPage(alignmentPosition)`	`Image`	لمحاذاة العنصر مع موضع المحاذاة المحدد على الصفحة
`bringForward()`	`Image`	لإحضار عنصر الصفحة إلى الأمام على الصفحة بمقدار عنصر واحد.
`bringToFront()`	`Image`	لإحضار عنصر الصفحة إلى مقدمة الصفحة.
`duplicate()`	`PageElement`	يكرّر عنصر الصفحة.
`getAs(contentType)`	`Blob`	عرض البيانات داخل هذا الكائن على شكل كائن ثنائي كبير يتم تحويله إلى نوع المحتوى المحدّد.
`getBlob()`	`Blob`	قم بإرجاع البيانات داخل هذه الصورة على شكل كائن ثنائي كبير (blob).
`getBorder()`	`Border`	يعرض `Border` للصورة.
`getConnectionSites()`	`ConnectionSite[]`	عرض قائمة `ConnectionSite`s على عنصر الصفحة، أو عرض قائمة فارغة إذا لم يكن عنصر الصفحة يحتوي على أي مواقع ربط.
`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)`

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

المَعلمات

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

المَعلمات

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

استرجاع الكرة

Blob — البيانات في صورة كائن ثنائي كبير (blob).

`getBlob()`

قم بإرجاع البيانات داخل هذه الصورة على شكل كائن ثنائي كبير (blob).

استرجاع الكرة

Blob - بيانات الصورة على شكل كائن ثنائي كبير (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 إذا لم يكن لعنصر الصفحة ارتفاع.

التفويض

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

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

المَعلمات

الاسم	Type	الوصف
`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);

المَعلمات

الاسم	Type	الوصف
`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);

المَعلمات

الاسم	Type	الوصف
`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().

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

المَعلمات

الاسم	Type	الوصف
`imageUrl`	`String`	عنوان URL لتنزيل الصورة منه.

استرجاع الكرة

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

التفويض

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

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

`replace(imageUrl, crop)`

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

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

المَعلمات

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

استرجاع الكرة

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

التفويض

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

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

`scaleHeight(ratio)`

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

المَعلمات

الاسم	Type	الوصف
`ratio`	`Number`	النسبة المستخدَمة لقياس ارتفاع عنصر الصفحة هذا.

استرجاع الكرة

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

التفويض

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

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

`scaleWidth(ratio)`

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

المَعلمات

الاسم	Type	الوصف
`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);
}

المَعلمات

الاسم	Type	الوصف
`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());

المَعلمات

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

استرجاع الكرة

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

التفويض

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

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

`setHeight(height)`

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

المَعلمات

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

استرجاع الكرة

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

التفويض

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

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

`setLeft(left)`

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

المَعلمات

الاسم	Type	الوصف
`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);

المَعلمات

الاسم	Type	الوصف
`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);

المَعلمات

الاسم	Type	الوصف
`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);

المَعلمات

الاسم	Type	الوصف
`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");

المَعلمات

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

استرجاع الكرة

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

التفويض

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

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

`setRotation(angle)`

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

المَعلمات

الاسم	Type	الوصف
`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());

المَعلمات

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

استرجاع الكرة

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

التفويض

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

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

`setTop(top)`

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

المَعلمات

الاسم	Type	الوصف
`top`	`Number`	الموضع الرأسي الجديد المطلوب تعيينه بالنقاط.

استرجاع الكرة

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

التفويض

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

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

`setTransform(transform)`

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

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

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

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

المَعلمات

الاسم	Type	الوصف
`transform`	`AffineTransform`	التحويل الذي يتم تعيينه لعنصر الصفحة هذا.

استرجاع الكرة

Image: هذا العنصر للسلاسل

التفويض

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

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

`setWidth(width)`

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

المَعلمات

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

استرجاع الكرة

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

التفويض

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

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