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

Class Shape

PageElement يمثّل شكلاً عامًا وليس له شكل أكثر تحديدًا الفئات. يتضمن مربعات النص والمستطيلات والأشكال الأخرى المحددة مسبقًا.

الطُرق

الطريقة	نوع الإرجاع	وصف قصير
`alignOnPage(alignmentPosition)`	`Shape`	لمحاذاة العنصر مع موضع المحاذاة المحدد على الصفحة.
`bringForward()`	`Shape`	لإحضار عنصر الصفحة إلى الأمام في الصفحة بواسطة عنصر واحد.
`bringToFront()`	`Shape`	لنقل عنصر الصفحة إلى مقدّمة الصفحة.
`duplicate()`	`PageElement`	يؤدي هذا الإجراء إلى تكرار عنصر الصفحة.
`getAutofit()`	`Autofit`	لعرض `Autofit` للنص داخل هذا الشكل.
`getBorder()`	`Border`	لعرض `Border` للشكل.
`getConnectionSites()`	`ConnectionSite[]`	عرض قائمة `ConnectionSite`s على عنصر الصفحة، أو قائمة فارغة إذا كانت الصفحة لا يحتوي على أي مواقع اتصال.
`getContentAlignment()`	`ContentAlignment`	لعرض `ContentAlignment` للنص في الشكل.
`getDescription()`	`String`	تعرض وصف النص البديل لعنصر الصفحة.
`getFill()`	`Fill`	لعرض `Fill` للشكل.
`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`	عرض زاوية تدوير العنصر في اتجاه عقارب الساعة حول مركزه بالدرجات، حيث تكون صفر درجة لا يعني الدوران.
`getShapeType()`	`ShapeType`	لعرض نوع الشكل.
`getText()`	`TextRange`	لعرض المحتوى النصي للشكل.
`getTitle()`	`String`	تعرض عنوان النص البديل لعنصر الصفحة.
`getTop()`	`Number`	الحصول على الموضع الرأسي للعنصر بالنقاط، ويتم قياسه من الزاوية العلوية اليسرى من الصفحة عندما لا يحتوي العنصر على تدوير.
`getTransform()`	`AffineTransform`	لعرض تحويل عنصر الصفحة.
`getWidth()`	`Number`	يتم عرض عرض العنصر بالنقاط، وهو عرض مربع إحاطة العنصر عندما فلن يحتوي العنصر على تدوير.
`preconcatenateTransform(transform)`	`Shape`	إنشاء تسلسل مسبق لعملية التحويل المتوفرة لعملية التحويل الحالية لعنصر الصفحة.
`remove()`	`void`	لإزالة عنصر الصفحة.
`removeLink()`	`void`	ستتم إزالة `Link`.
`replaceWithImage(blobSource)`	`Image`	لاستبدال هذا الشكل بصورة مقدمة من `BlobSource`.
`replaceWithImage(blobSource, crop)`	`Image`	لاستبدال هذا الشكل بصورة مقدمة من `BlobSource`.
`replaceWithImage(imageUrl)`	`Image`	لاستبدال هذا الشكل بصورة.
`replaceWithImage(imageUrl, crop)`	`Image`	لاستبدال هذا الشكل بصورة.
`replaceWithSheetsChart(sourceChart)`	`SheetsChart`	استبدال هذا الشكل بمخطط في "جداول بيانات Google"
`replaceWithSheetsChartAsImage(sourceChart)`	`Image`	لاستبدال هذا الشكل بصورة رسم بياني في "جداول بيانات Google".
`scaleHeight(ratio)`	`Shape`	تعمل على قياس ارتفاع العنصر بنسبة محددة.
`scaleWidth(ratio)`	`Shape`	تعمل هذه السمة على زيادة عرض العنصر وفقًا للنسبة المحددة.
`select()`	`void`	يؤدي هذا الإجراء إلى اختيار `PageElement` فقط في العرض التقديمي النشط وإزالة أي عناصر سابقة. التحديد.
`select(replace)`	`void`	لاختيار "`PageElement`" في العرض التقديمي النشط
`sendBackward()`	`Shape`	لإعادة عنصر الصفحة إلى الخلف في الصفحة بواسطة عنصر واحد.
`sendToBack()`	`Shape`	لإرسال عنصر الصفحة إلى الجزء الخلفي من الصفحة
`setContentAlignment(contentAlignment)`	`Shape`	لتعيين `ContentAlignment` من النص في الشكل.
`setDescription(description)`	`Shape`	لضبط وصف النص البديل لعنصر الصفحة.
`setHeight(height)`	`Shape`	لتعيين ارتفاع العنصر بالنقاط، وهو ارتفاع مربع إحاطة العنصر عند لا يحتوي العنصر على تدوير.
`setLeft(left)`	`Shape`	لتعيين الموضع الأفقي للعنصر، بالنقاط، التي يتم قياسها من الزاوية العلوية اليسرى من عندما لا يحتوي العنصر على تدوير.
`setLinkSlide(slideIndex)`	`Link`	لضبط `Link` على `Slide` المحدّد باستخدام فهرس الشريحة الصفرية
`setLinkSlide(slide)`	`Link`	لضبط `Link` على `Slide` المحدّد، يتم ضبط الرابط من خلال رقم تعريف الشريحة المحدّد.
`setLinkSlide(slidePosition)`	`Link`	لضبط `Link` على `Slide` المحدّد باستخدام الموضع النسبي للشريحة
`setLinkUrl(url)`	`Link`	تضبط `Link` على سلسلة عنوان URL غير الفارغة المحدّدة.
`setRotation(angle)`	`Shape`	تضبط زاوية تدوير العنصر في اتجاه عقارب الساعة حول مركزه بالدرجات.
`setTitle(title)`	`Shape`	لتعيين عنوان النص البديل لعنصر الصفحة.
`setTop(top)`	`Shape`	يضبط الموضع الرأسي للعنصر بالنقاط، ويتم قياسه من الزاوية العلوية اليسرى من الصفحة. عندما لا يحتوي العنصر على تدوير.
`setTransform(transform)`	`Shape`	لضبط تحويل عنصر الصفحة باستخدام التحويل المتوفر.
`setWidth(width)`	`Shape`	لتعيين عرض العنصر بالنقاط، وهو عرض مربع إحاطة العنصر عندما لا يحتوي العنصر على تدوير.

الوثائق التفصيلية

`alignOnPage(alignmentPosition)`

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

المعلمات

الاسم	النوع	الوصف
`alignmentPosition`	`AlignmentPosition`	الموضع الذي يجب محاذاة عنصر الصفحة هذا معه على الصفحة.

الإرجاع

Shape — عنصر الصفحة هذا، للتسلسل.

`bringForward()`

لإحضار عنصر الصفحة إلى الأمام في الصفحة بواسطة عنصر واحد.

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

الإرجاع

Shape — عنصر الصفحة هذا، للتسلسل.

التفويض

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

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

`bringToFront()`

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

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

الإرجاع

Shape — عنصر الصفحة هذا، للتسلسل.

التفويض

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

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

`getAutofit()`

لعرض Autofit للنص داخل هذا الشكل. يكون هذا null إذا كان الشكل لا يسمح بالنص.

الإرجاع

Autofit — الاحتواء التلقائي للنص داخل هذا الشكل.

التفويض

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

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

`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

`getContentAlignment()`

لعرض ContentAlignment للنص في الشكل.

الإرجاع

ContentAlignment - محاذاة النص داخل هذا الشكل.

التفويض

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

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

`getFill()`

لعرض Fill للشكل.

الإرجاع

Fill — إعداد التعبئة لهذا الشكل.

التفويض

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

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

`getShapeType()`

لعرض نوع الشكل.

الإرجاع

ShapeType — نوع هذا الشكل.

`getText()`

لعرض المحتوى النصي للشكل.

ينتهي دائمًا النص داخل شكل بحرف سطر جديد.

الإرجاع

TextRange — المحتوى النصي لهذا الشكل.

التفويض

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

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

الإرجاع

Shape — عنصر الصفحة هذا، للتسلسل.

التفويض

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

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

`replaceWithImage(blobSource)`

لاستبدال هذا الشكل بصورة مقدمة من BlobSource.

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

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

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

المعلمات

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

الإرجاع

Image — Image الذي حل محل الشكل

التفويض

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

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

`replaceWithImage(blobSource, crop)`

لاستبدال هذا الشكل بصورة مقدمة من BlobSource.

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

var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
// Get the Drive image file with the given ID.
var driveImage = DriveApp.getFileById(fileId);
// Replace and crop the replaced image.
shape.replaceWithImage(driveImage, true);

المعلمات

الاسم	النوع	الوصف
`blobSource`	`BlobSource`	بيانات الصورة
`crop`	`Boolean`	إذا كان `true`، سيتم اقتصاص الصورة لتلائم حجم الشكل الحالي. بخلاف ذلك، سيتم يتم تحجيم الصورة وتوسيطها.

الإرجاع

Image — Image الذي حل محل الشكل

التفويض

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

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

`replaceWithImage(imageUrl)`

لاستبدال هذا الشكل بصورة.

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

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

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

المعلمات

الاسم	النوع	الوصف
`imageUrl`	`String`	عنوان URL الخاص بالصورة المطلوب تنزيل الصورة منها

الإرجاع

Image — Image الذي حل محل الشكل

التفويض

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

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

`replaceWithImage(imageUrl, crop)`

لاستبدال هذا الشكل بصورة.

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

المعلمات

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

الإرجاع

Image — Image الذي حل محل الشكل

التفويض

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

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

`replaceWithSheetsChart(sourceChart)`

يستبدل هذا الشكل بمخطط في "جداول بيانات Google".

يرتبط الرسم البياني بمخطط "جداول بيانات Google" المصدر، ما يسمح بتعديله. مشاكل أخرى ويمكن للمتعاونين رؤية الرابط إلى جدول البيانات المصدر.

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart.
var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
shape.replaceWithSheetsChart(chart);

المعلمات

الاسم	النوع	الوصف
`sourceChart`	`EmbeddedChart`	مخطط في جدول بيانات يحل محل الشكل.

الإرجاع

SheetsChart — الرسم البياني الذي حل محل الشكل

التفويض

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

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

`replaceWithSheetsChartAsImage(sourceChart)`

لاستبدال هذا الشكل بصورة رسم بياني في "جداول بيانات Google".

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

صورة الرسم البياني غير مرتبطة بالرسم البياني المصدر في "جداول بيانات Google".

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart as an image.
var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
shape.replaceWithSheetsChartAsImage(chart);

المعلمات

الاسم	النوع	الوصف
`sourceChart`	`EmbeddedChart`	مخطط في جدول بيانات يحل محل الشكل.

الإرجاع

Image — صورة الرسم البياني التي حلت محل الشكل

التفويض

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

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

`scaleHeight(ratio)`

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

المعلمات

الاسم	النوع	الوصف
`ratio`	`Number`	يشير ذلك المصطلح إلى النسبة المستخدمة في قياس ارتفاع عنصر الصفحة هذا.

الإرجاع

Shape — عنصر الصفحة هذا، للتسلسل.

التفويض

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

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

`scaleWidth(ratio)`

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

المعلمات

الاسم	النوع	الوصف
`ratio`	`Number`	يشير ذلك المصطلح إلى النسبة المستخدَمة لقياس عرض عنصر الصفحة هذا.

الإرجاع

Shape — عنصر الصفحة هذا، للتسلسل.

التفويض

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

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

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

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

الإرجاع

Shape — عنصر الصفحة هذا، للتسلسل.

التفويض

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

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

`sendToBack()`

لإرسال عنصر الصفحة إلى الجزء الخلفي من الصفحة

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

الإرجاع

Shape — عنصر الصفحة هذا، للتسلسل.

التفويض

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

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

`setContentAlignment(contentAlignment)`

لتعيين ContentAlignment من النص في الشكل.

تؤدي هذه الطريقة إلى إيقاف خصائص الاحتواء التلقائي للنص في الأشكال التي تم تعديلها.

المعلمات

الاسم	النوع	الوصف
`contentAlignment`	`ContentAlignment`	المحاذاة المطلوب تعيينها.

الإرجاع

Shape: هذا الشكل للسلاسل

التفويض

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

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

الإرجاع

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

التفويض

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

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

`setHeight(height)`

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

المعلمات

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

الإرجاع

Shape — عنصر الصفحة هذا، للتسلسل.

التفويض

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

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

`setLeft(left)`

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

المعلمات

الاسم	النوع	الوصف
`left`	`Number`	الموضع الأفقي الجديد الذي يجب تحديده بالنقاط.

الإرجاع

Shape — عنصر الصفحة هذا، للتسلسل.

التفويض

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

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`	زاوية التدوير الجديدة في اتجاه عقارب الساعة المطلوب ضبطها، بالدرجات.

الإرجاع

Shape — عنصر الصفحة هذا، للتسلسل.

التفويض

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

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

الإرجاع

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

التفويض

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

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

`setTop(top)`

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

المعلمات

الاسم	النوع	الوصف
`top`	`Number`	الموضع العمودي الجديد الذي يجب تحديده بالنقاط

الإرجاع

Shape — عنصر الصفحة هذا، للتسلسل.

التفويض

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

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

`setTransform(transform)`

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

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

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

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

المعلمات

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

الإرجاع

Shape — هذا العنصر، للتسلسل.

التفويض

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

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

`setWidth(width)`

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

المعلمات

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

الإرجاع

Shape — عنصر الصفحة هذا، للتسلسل.

التفويض

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

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