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 في حال عدم توفّر رابط. 

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: 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

التفويض

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

  • 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 نقطة إلى اليسار: 

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الفهرس الذي يبدأ من الصفر للشريحة

الإرجاع

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

المعلمات

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

الإرجاع

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