Class Shape

الشكل

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

الطُرق

الطريقةنوع القيمة التي تم إرجاعهاوصف قصير
alignOnPage(alignmentPosition)Shapeتعمل هذه السمة على محاذاة العنصر مع موضع المحاذاة المحدّد على الصفحة.
bringForward()Shapeيقدّم عنصر الصفحة إلى الأمام على الصفحة بمقدار عنصر واحد.
bringToFront()Shapeيتم عرض عنصر الصفحة في مقدّمة الصفحة.
duplicate()PageElementتكرِّر هذه السمة عنصر الصفحة.
getAutofit()Autofit|nullتعرض هذه السمة Autofit النص داخل هذا الشكل.
getBorder()Borderتعرض Border للشكل.
getConnectionSites()ConnectionSite[]تعرض هذه السمة قائمة ConnectionSites في عنصر الصفحة، أو قائمة فارغة إذا كان عنصر الصفحة لا يتضمّن أي مواقع إلكترونية مرتبطة.
getContentAlignment()ContentAlignmentتعرض هذه السمة ContentAlignment النص في الشكل.
getDescription()Stringتعرض هذه السمة وصف النص البديل لعنصر الصفحة.
getFill()Fillتعرض Fill للشكل.
getHeight()Number|nullتعرض هذه السمة ارتفاع العنصر بالنقاط، وهو ارتفاع المربّع المحيط بالعنصر عندما لا يكون العنصر مدوّرًا.
getInherentHeight()Number|nullتعرض هذه السمة الارتفاع المتأصّل للعنصر بالنقاط.
getInherentWidth()Number|nullتعرض هذه السمة العرض المضمّن للعنصر بالنقاط.
getLeft()Numberتعرض هذه السمة الموضع الأفقي للعنصر بالنقاط، ويتم قياسه من الزاوية العلوية اليمنى من الصفحة عندما لا يكون العنصر في وضع تدوير.
getLink()Link|nullتعرِض هذه الدالة Link أو null إذا لم يكن هناك رابط.
getObjectId()Stringتعرِض هذه السمة المعرّف الفريد لهذا العنصر.
getPageElementType()PageElementTypeتعرض هذه السمة نوع عنصر الصفحة، ويتم تمثيله كقيمة تعداد PageElementType.
getParentGroup()Group|nullتعرض هذه السمة المجموعة التي ينتمي إليها عنصر الصفحة هذا، أو null إذا لم يكن العنصر في مجموعة.
getParentPage()Pageتعرض هذه السمة الصفحة التي يظهر عليها عنصر الصفحة هذا.
getParentPlaceholder()PageElement|nullتعرض هذه السمة عنصر الصفحة الرئيسية للعنصر النائب.
getPlaceholderIndex()Integer|nullتعرِض هذه السمة فهرس العنصر النائب للشكل.
getPlaceholderType()PlaceholderTypeتعرض هذه الدالة نوع العنصر النائب للشكل، أو PlaceholderType.NONE إذا لم يكن الشكل عنصرًا نائبًا.
getRotation()Numberتعرض هذه السمة زاوية تدوير العنصر في اتجاه عقارب الساعة حول مركزه بالدرجات، حيث تعني الدرجة صفر عدم التدوير.
getShapeType()ShapeTypeتعرِض هذه السمة نوع الشكل.
getText()TextRangeتعرض هذه السمة المحتوى النصي للشكل.
getTitle()Stringتعرض هذه السمة عنوان النص البديل لعنصر الصفحة.
getTop()Numberتعرض هذه السمة الموضع الرأسي للعنصر بالنقاط، ويتم قياسه من الزاوية العلوية اليسرى للصفحة عندما لا يكون العنصر مدوّرًا.
getTransform()AffineTransformتعرض هذه السمة تحويل عنصر الصفحة.
getWidth()Number|nullتعرض هذه السمة عرض العنصر بالنقاط، وهو عرض المربّع المحيط بالعنصر عندما لا يكون العنصر مدوّرًا.
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|null — الاحتواء التلقائي للنص داخل هذا الشكل.

التفويض

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

  • 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: الارتفاع الأساسي لعنصر الصفحة بالنقاط، أو null إذا لم يكن لعنصر الصفحة ارتفاع.

التفويض

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

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

getInherentHeight()

تعرض هذه السمة الارتفاع المتأصّل للعنصر بالنقاط.

يكون تحويل عنصر الصفحة مرتبطًا بحجمه الأصلي. استخدِم الحجم المتأصّل مع تحويل العنصر لتحديد المظهر المرئي النهائي للعنصر.

الإرجاع

‫Number|null: الارتفاع الأساسي لعنصر الصفحة بالنقاط، أو null إذا لم يكن لعنصر الصفحة ارتفاع.

التفويض

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

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

getInherentWidth()

تعرض هذه السمة العرض المضمّن للعنصر بالنقاط.

يكون تحويل عنصر الصفحة مرتبطًا بحجمه الأصلي. استخدِم الحجم المتأصّل مع تحويل العنصر لتحديد المظهر المرئي النهائي للعنصر.

الإرجاع

‫Number|null: يمثّل العرض المضمّن لعنصر الصفحة بالنقاط، أو 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 إذا لم يكن هناك رابط. 

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const link = shape.getLink();
if (link != null) {
  Logger.log(`Shape has a link of type: ${link.getLinkType()}`);
}

الإرجاع

Link|null: Link أو null إذا لم يكن هناك رابط

التفويض

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

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

getObjectId()

تعرِض هذه السمة المعرّف الفريد لهذا العنصر. تتشارك معرّفات العناصر التي تستخدمها الصفحات وعناصر الصفحات مساحة الاسم نفسها.

الإرجاع

استبدِل String بالمعرّف الفريد لهذا العنصر.

التفويض

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

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

getPageElementType()

تعرض هذه السمة نوع عنصر الصفحة، ويتم تمثيله كقيمة تعداد PageElementType.

الإرجاع

PageElementType: نوع عنصر الصفحة

التفويض

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

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

getParentGroup()

تعرض هذه السمة المجموعة التي ينتمي إليها عنصر الصفحة هذا، أو null إذا لم يكن العنصر في مجموعة.

الإرجاع

Group|null: المجموعة التي ينتمي إليها عنصر الصفحة هذا، أو 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: عنصر الصفحة الرئيسي لعنصر نائب خاص بهذا الشكل، أو null إذا لم يكن هذا الشكل عنصرًا نائبًا أو لم يكن له عنصر رئيسي.

التفويض

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

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

getPlaceholderIndex()

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

الإرجاع

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

التفويض

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

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

preconcatenateTransform(transform)

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

newTransform = argument * existingTransform;

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

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

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

المعلمات

الاسمالنوعالوصف
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. 

const slides = SlidesApp.getActivePresentation().getSlides();
slides[1].getShapes()[0].removeLink();

replaceWithImage(blobSource)

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

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

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

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

المعلمات

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

الإرجاع

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. 

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

المعلمات

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

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

المعلمات

الاسمالنوعالوصف
imageUrlStringتمثّل هذه السمة عنوان URL الخاص بالصورة المطلوب تنزيلها.

الإرجاع

Image: Image الذي تم استبدال الشكل به

التفويض

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

  • 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، يتم اقتصاص الصورة لتناسب حجم الشكل الحالي. وإلا، يتم تغيير حجم الصورة وتوسيطها.

الإرجاع

Image: Image الذي تم استبدال الشكل به

التفويض

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

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

replaceWithSheetsChart(sourceChart)

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

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

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart.
const 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". 

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart as an image.
const 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. 

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const pageElement = slide.getPageElements()[0];
// Only select this page element and replace any previous selection.
pageElement.select();

التفويض

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

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

select(replace)

يختار PageElement في العرض التقديمي النشط.

لا يمكن للنص البرمجي الوصول إلى تحديد المستخدم الذي يشغّل النص البرمجي إلا إذا كان النص البرمجي مرتبطًا بالعرض التقديمي.

مرِّر true إلى هذه الطريقة لاختيار PageElement فقط وإزالة أي اختيار سابق. يؤدي ذلك أيضًا إلى ضبط Page للعنصر الرئيسي PageElement على current page selection.

اضغط على false لتحديد عدة عناصر PageElement. يجب أن تكون عناصر PageElement في Page نفسها.

يجب استيفاء الشروط التالية عند اختيار عنصر صفحة باستخدام مَعلمة false:

  1. يجب أن يكون العنصر الرئيسي Page للعنصر PageElement هو current page selection.
  2. يجب عدم اختيار عناصر Page متعدّدة.

للتأكّد من ذلك، يُفضّل اختيار العنصر الأصل Page أولاً باستخدام Page.selectAsCurrentPage()، ثم اختيار عناصر الصفحة في تلك الصفحة. 

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// First select the slide page, as the current page selection.
slide.selectAsCurrentPage();
// Then select all the page elements in the selected slide page.
const pageElements = slide.getPageElements();
for (let i = 0; i < pageElements.length; i++) {
  pageElements[i].select(false);
}

المعلمات

الاسمالنوعالوصف
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".
const 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.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(0);

المعلمات

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

الإرجاع

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

التفويض

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

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

setLinkSlide(slide)

يضبط هذا الإجراء Link على Slide المحدّد، ويتم ضبط الرابط باستخدام معرّف الشريحة المحدّد. 

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(slides[0]);

المعلمات

الاسمالنوعالوصف
slideSlideتمثّل Slide الحساب المطلوب ربطه.

الإرجاع

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

التفويض

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

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

setLinkSlide(slidePosition)

يضبط Link على Slide المحدّد باستخدام الموضع النسبي للشريحة. 

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);

المعلمات

الاسمالنوعالوصف
slidePositionSlidePositionتمثّل هذه السمة SlidePosition النسبي.

الإرجاع

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

التفويض

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

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

setLinkUrl(url)

تضبط هذه السمة قيمة Link على سلسلة عنوان URL غير فارغة. 

// Set a link to the URL.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkUrl('https://slides.google.com');

المعلمات

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

الإرجاع

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

التفويض

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

  • 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".
const 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