Class Shape

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

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

الطُرق

الطريقةنوع الإرجاعوصف قصير
alignOnPage(alignmentPosition)Shapeلمحاذاة العنصر مع موضع المحاذاة المحدد في الصفحة.
bringForward()Shapeلجلب عنصر الصفحة للأمام على الصفحة بواسطة عنصر واحد.
bringToFront()Shapeلجلب عنصر الصفحة إلى مقدمة الصفحة.
duplicate()PageElementتكرار عنصر الصفحة.
getAutofit()Autofitلعرض Autofit من النص داخل هذا الشكل.
getBorder()Borderلعرض Border للشكل.
getConnectionSites()ConnectionSite[]لعرض قائمة من ConnectionSite في عنصر الصفحة، أو قائمة فارغة إذا لم يكن عنصر الصفحة يحتوي على أي مواقع اتصال.
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)

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

المَعلمات

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

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

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

لعرض قائمة من ConnectionSite في عنصر الصفحة، أو قائمة فارغة إذا لم يكن عنصر الصفحة يحتوي على أي مواقع اتصال.

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

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

لعرض 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).

المَعلمات

الاسمالنوعالوصف
transformAffineTransformعملية التحويل إلى تسلسل مسبق إلى تحويل عنصر الصفحة هذا.

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

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

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

المَعلمات

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

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

ImageImage التي حلت محل الشكل.

التفويض

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

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

المَعلمات

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

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

ImageImage التي حلت محل الشكل.

التفويض

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

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

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

المَعلمات

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

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

ImageImage التي حلت محل الشكل.

التفويض

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

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

replaceWithImage(imageUrl, crop)

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

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

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

المَعلمات

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

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

ImageImage التي حلت محل الشكل.

التفويض

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

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

المَعلمات

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

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

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

المَعلمات

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

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

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

التفويض

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

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

scaleHeight(ratio)

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

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

المَعلمات

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

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

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

التفويض

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

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

scaleWidth(ratio)

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

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

المَعلمات

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

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

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:

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

المَعلمات

الاسمالنوعالوصف
replaceBooleanإذا تم تحديد 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 للنص الوارد في الشكل.

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

المَعلمات

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

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

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

المَعلمات

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

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

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

التفويض

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

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

setHeight(height)

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

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

المَعلمات

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

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

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

التفويض

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

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

setLeft(left)

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

المَعلمات

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

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

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

المَعلمات

الاسمالنوعالوصف
slideIndexIntegerفهرس مستند إلى الصفر في الشريحة.

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

LinkLink التي تم تعيينها

التفويض

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

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

المَعلمات

الاسمالنوعالوصف
slideSlideSlide المطلوب ربطه.

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

LinkLink التي تم تعيينها

التفويض

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

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

المَعلمات

الاسمالنوعالوصف
slidePositionSlidePositionقيمة SlidePosition النسبية

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

LinkLink التي تم تعيينها

التفويض

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

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

المَعلمات

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

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

LinkLink التي تم تعيينها

التفويض

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

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

setRotation(angle)

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

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

المَعلمات

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

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

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

المَعلمات

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

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

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

التفويض

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

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

setTop(top)

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

المَعلمات

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

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

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

التفويض

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

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

setTransform(transform)

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

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

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

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

المَعلمات

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

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

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

التفويض

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

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

setWidth(width)

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

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

المَعلمات

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

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

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

التفويض

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

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