Class Line

السطر

PageElement يمثّل خطًا.

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
alignOnPage(alignmentPosition)Lineتعمل هذه السمة على محاذاة العنصر مع موضع المحاذاة المحدّد على الصفحة.
bringForward()Lineيقدّم عنصر الصفحة إلى الأمام على الصفحة بمقدار عنصر واحد.
bringToFront()Lineيتم عرض عنصر الصفحة في مقدّمة الصفحة.
duplicate()PageElementتكرِّر هذه السمة عنصر الصفحة.
getConnectionSites()ConnectionSite[]تعرض هذه السمة قائمة ConnectionSites في عنصر الصفحة، أو قائمة فارغة إذا كان عنصر الصفحة لا يتضمّن أي مواقع إلكترونية مرتبطة.
getDashStyle()DashStyleتعرض هذه السمة DashStyle السطر.
getDescription()Stringتعرض هذه السمة وصف النص البديل لعنصر الصفحة.
getEnd()Pointتعرض هذه السمة نقطة نهاية الخط، ويتم قياسها من أعلى يمين الصفحة.
getEndArrow()ArrowStyleتعرض هذه السمة ArrowStyle السهم في نهاية السطر.
getEndConnection()ConnectionSite|nullتعرض هذه السمة الاتصال في نهاية السطر، أو null إذا لم يكن هناك اتصال.
getHeight()Number|nullتعرض هذه السمة ارتفاع العنصر بالنقاط، وهو ارتفاع المربّع المحيط بالعنصر عندما لا يكون العنصر مدوّرًا.
getInherentHeight()Number|nullتعرض هذه السمة الارتفاع المتأصّل للعنصر بالنقاط.
getInherentWidth()Number|nullتعرض هذه السمة العرض المضمّن للعنصر بالنقاط.
getLeft()Numberتعرض هذه السمة الموضع الأفقي للعنصر بالنقاط، ويتم قياسه من الزاوية العلوية اليمنى من الصفحة عندما لا يكون العنصر في وضع تدوير.
getLineCategory()LineCategoryتعرض هذه السمة LineCategory السطر.
getLineFill()LineFillتعرض هذه السمة LineFill السطر.
getLineType()LineTypeتعرض هذه السمة LineType السطر.
getLink()Link|nullتعرِض Link أو null إذا لم يكن هناك رابط.
getObjectId()Stringتعرض هذه الطريقة المعرّف الفريد لهذا العنصر.
getPageElementType()PageElementTypeتعرض هذه السمة نوع عنصر الصفحة، ويتم تمثيله كقيمة تعداد PageElementType.
getParentGroup()Group|nullتعرض هذه السمة المجموعة التي ينتمي إليها عنصر الصفحة، أو null إذا لم يكن العنصر في مجموعة.
getParentPage()Pageتعرض هذه السمة الصفحة التي يظهر عليها عنصر الصفحة هذا.
getRotation()Numberتعرض هذه السمة زاوية تدوير العنصر في اتجاه عقارب الساعة حول مركزه بالدرجات، حيث تعني الدرجة صفر عدم التدوير.
getStart()Pointتعرض هذه السمة نقطة بداية السطر، ويتم قياسها من أعلى يمين الصفحة.
getStartArrow()ArrowStyleتعرض هذه السمة ArrowStyle السهم في بداية السطر.
getStartConnection()ConnectionSite|nullتعرض هذه السمة نقطة الاتصال في بداية الخط، أو null إذا لم يكن هناك اتصال.
getTitle()Stringتعرض هذه السمة عنوان النص البديل لعنصر الصفحة.
getTop()Numberتعرض هذه السمة الموضع العمودي للعنصر بالنقاط، ويتم قياسه من الزاوية العلوية اليسرى للصفحة عندما لا يكون العنصر في وضع تدوير.
getTransform()AffineTransformتعرض هذه السمة تحويل عنصر الصفحة.
getWeight()Numberتعرض هذه السمة سُمك الخط بالنقاط.
getWidth()Number|nullتعرض هذه السمة عرض العنصر بالنقاط، وهو عرض المربّع المحيط بالعنصر عندما لا يكون العنصر مدوّرًا.
isConnector()Booleanتعرض الدالة true إذا كان الخط موصلاً، أو false إذا لم يكن كذلك.
preconcatenateTransform(transform)Lineيتم دمج عملية التحويل المقدَّمة مع عملية التحويل الحالية لعنصر الصفحة.
remove()voidتزيل هذه الطريقة عنصر الصفحة.
removeLink()voidتزيل هذه الطريقة Link.
reroute()Lineتعيد توجيه بداية الخط ونهايته إلى أقرب موقعَين للاتصال على عناصر الصفحة المرتبطة.
scaleHeight(ratio)Lineتغيّر حجم ارتفاع العنصر حسب النسبة المحدّدة.
scaleWidth(ratio)Lineتغيّر حجم عرض العنصر حسب النسبة المحدّدة.
select()voidيحدّد هذا الخيار PageElement في العرض التقديمي النشط فقط ويزيل أي تحديد سابق.
select(replace)voidيختار هذا الخيار PageElement في العرض التقديمي النشط.
sendBackward()Lineيرسل عنصر الصفحة إلى الخلف بمقدار عنصر واحد.
sendToBack()Lineيرسل عنصر الصفحة إلى خلف الصفحة.
setDashStyle(style)Lineتضبط هذه السمة DashStyle للخط.
setDescription(description)Lineتضبط هذه السمة وصف النص البديل لعنصر الصفحة.
setEnd(left, top)Lineتضبط هذه السمة موضع نقطة نهاية الخط.
setEnd(point)Lineتضبط هذه السمة موضع نقطة نهاية الخط.
setEndArrow(style)Lineتضبط هذه السمة ArrowStyle للسهم في نهاية السطر.
setEndConnection(connectionSite)Lineتضبط هذه السمة موضع الاتصال في نهاية السطر.
setHeight(height)Lineتضبط هذه السمة ارتفاع العنصر بالنقاط، وهو ارتفاع المربّع المحيط بالعنصر عندما لا يكون العنصر مدوّرًا.
setLeft(left)Lineتضبط هذه السمة الموضع الأفقي للعنصر بالنقاط، ويتم قياسه من الزاوية العلوية اليمنى للصفحة عندما لا يكون العنصر في وضع تدوير.
setLineCategory(lineCategory)Lineتضبط هذه السمة LineCategory للخط.
setLinkSlide(slideIndex)Linkيضبط Link على Slide المحدّد باستخدام الفهرس المستند إلى الصفر للشريحة.
setLinkSlide(slide)Linkيضبط Link على Slide المحدّد، ويتم ضبط الرابط حسب معرّف الشريحة المحدّد.
setLinkSlide(slidePosition)Linkيضبط Link على Slide المحدّد باستخدام الموضع النسبي للشريحة.
setLinkUrl(url)Linkتضبط هذه السمة Link على سلسلة عنوان URL غير فارغة.
setRotation(angle)Lineتضبط هذه السمة زاوية تدوير العنصر في اتجاه عقارب الساعة حول مركزه بالدرجات.
setStart(left, top)Lineتضبط هذه السمة موضع نقطة بداية الخط.
setStart(point)Lineتضبط هذه السمة موضع نقطة بداية الخط.
setStartArrow(style)Lineتضبط هذه السمة ArrowStyle السهم في بداية السطر.
setStartConnection(connectionSite)Lineتضبط هذه السمة موضع الاتصال في بداية السطر.
setTitle(title)Lineتضبط هذه السمة عنوان النص البديل لعنصر الصفحة.
setTop(top)Lineتضبط هذه السمة الموضع العمودي للعنصر بالنقاط، ويتم قياسه من الزاوية العلوية اليسرى للصفحة عندما لا يكون العنصر مدوّرًا.
setTransform(transform)Lineتضبط هذه السمة تحويل عنصر الصفحة باستخدام التحويل المقدَّم.
setWeight(points)Lineتضبط هذه السمة سمك الخط بالنقاط.
setWidth(width)Lineتضبط هذه السمة عرض العنصر بالنقاط، وهو عرض المربّع المحيط بالعنصر عندما لا يكون العنصر مدوّرًا.

مستندات تفصيلية

alignOnPage(alignmentPosition)

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

المعلمات

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

الإرجاع

Line: عنصر الصفحة هذا، ويُستخدم في الربط.

bringForward()

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

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

الإرجاع

Line: عنصر الصفحة هذا، ويُستخدم في الربط.

التفويض

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

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

bringToFront()

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

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

الإرجاع

Line: عنصر الصفحة هذا، ويُستخدم في الربط.

التفويض

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

  • 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

getConnectionSites()

تعرض هذه السمة قائمة ConnectionSites في عنصر الصفحة، أو قائمة فارغة إذا كان عنصر الصفحة لا يتضمّن أي مواقع إلكترونية مرتبطة.

الإرجاع

‫ConnectionSite[]: قائمة المواقع الإلكترونية المرتبطة، والتي قد تكون فارغة إذا لم يكن لهذا العنصر أي مواقع إلكترونية مرتبطة.

التفويض

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

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

getDashStyle()

تعرض هذه السمة DashStyle السطر.

الإرجاع

DashStyle: نمط الخطوط المتقطّعة المستخدَمة مع هذا الخط

التفويض

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

  • 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

getEnd()

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

الإرجاع

Point: نقطة نهاية الخط.

التفويض

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

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

getEndArrow()

تعرض هذه السمة ArrowStyle السهم في نهاية السطر.

الإرجاع

ArrowStyle: نمط السهم في نهاية هذا الخط

التفويض

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

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

getEndConnection()

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

الإرجاع

ConnectionSite|null: هي الاتصال في نهاية السطر.

التفويض

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

  • 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

getLineCategory()

تعرض هذه السمة LineCategory السطر.

الإرجاع

‫LineCategory: فئة الخط

التفويض

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

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

getLineFill()

تعرض هذه السمة LineFill السطر.

الإرجاع

LineFill: يمثّل إعداد التعبئة لهذا الخط.

التفويض

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

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

getLineType()

تعرض هذه السمة LineType السطر.

الإرجاع

‫LineType: نوع هذا السطر

التفويض

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

  • 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

getRotation()

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

الإرجاع

Number: زاوية الدوران بالدرجات بين 0 (شامل) و360 (غير شامل).

التفويض

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

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

getStart()

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

الإرجاع

Point: نقطة بداية الخط.

التفويض

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

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

getStartArrow()

تعرض هذه السمة ArrowStyle السهم في بداية السطر.

الإرجاع

ArrowStyle: نمط السهم في بداية هذا الخط

التفويض

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

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

getStartConnection()

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

الإرجاع

ConnectionSite|null: يمثّل هذا الرمز الاتصال في بداية السطر.

التفويض

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

  • 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

getWeight()

تعرض هذه السمة سُمك الخط بالنقاط.

الإرجاع

Number: تمثّل سُمك الخط بالنقاط.

التفويض

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

  • 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

isConnector()

تعرض الدالة true إذا كان الخط موصلاً، أو false إذا لم يكن كذلك.

الموصّل هو نوع من الخطوط يُستخدَم لربط مواقع الاتصال بعناصر الصفحة ذات الصلة. يمكن ربط كل طرف من الموصل بموقع ربط واحد على الأكثر.

الإرجاع

‫Boolean — True إذا كان الخط موصلاً، أو false إذا لم يكن كذلك

التفويض

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

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

الإرجاع

Line: عنصر الصفحة هذا، ويُستخدم في الربط.

التفويض

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

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

reroute()

تعيد توجيه بداية الخط ونهايته إلى أقرب موقعَين للاتصال على عناصر الصفحة المرتبطة. يجب أن تكون بداية الخط ونهايته مرتبطتَين بعناصر مختلفة في الصفحة.

الإرجاع

Line — الخط

التفويض

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

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

scaleHeight(ratio)

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

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

المعلمات

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

الإرجاع

Line: عنصر الصفحة هذا، ويُستخدم في الربط.

التفويض

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

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

scaleWidth(ratio)

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

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

المعلمات

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

الإرجاع

Line: عنصر الصفحة هذا، ويُستخدم في الربط.

التفويض

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

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

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

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

الإرجاع

Line: عنصر الصفحة هذا، ويُستخدم في الربط.

التفويض

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

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

sendToBack()

يرسل عنصر الصفحة إلى خلف الصفحة.

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

الإرجاع

Line: عنصر الصفحة هذا، ويُستخدم في الربط.

التفويض

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

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

setDashStyle(style)

تضبط هذه السمة DashStyle للخط.

المعلمات

الاسمالنوعالوصف
styleDashStyleتمثّل هذه السمة نمط الخط المتقطّع الذي سيتم ضبطه لهذا الخط.

الإرجاع

Line: هذا السطر مخصّص للربط.

التفويض

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

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

الإرجاع

Line: عنصر الصفحة هذا

التفويض

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

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

setEnd(left, top)

تضبط هذه السمة موضع نقطة نهاية الخط.

يمكن تعديل مسار الخط بعد تغيير الموضع.

المعلمات

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

الإرجاع

Line: هذا السطر مخصّص للربط.

التفويض

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

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

setEnd(point)

تضبط هذه السمة موضع نقطة نهاية الخط.

يمكن تعديل مسار الخط بعد تغيير الموضع.

المعلمات

الاسمالنوعالوصف
pointPointنقطة نهاية الخط، ويتم قياس موضعها من أعلى يمين الصفحة.

الإرجاع

Line: هذا السطر مخصّص للربط.

التفويض

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

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

setEndArrow(style)

تضبط هذه السمة ArrowStyle للسهم في نهاية السطر.

المعلمات

الاسمالنوعالوصف
styleArrowStyleنمط الخط المطلوب ضبطه.

الإرجاع

Line: هذا السطر مخصّص للربط.

التفويض

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

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

setEndConnection(connectionSite)

تضبط هذه السمة موضع الاتصال في نهاية السطر. ويؤدي ذلك إلى نقل نهاية الخط إلى موقع الربط المحدّد مع الحفاظ على الطرف الآخر.

المعلمات

الاسمالنوعالوصف
connectionSiteConnectionSiteتم تعديل الموقع الإلكتروني المرتبط بنهاية الاتصال إلى null أو تمت إزالته.

الإرجاع

Line — الخط

التفويض

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

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

setHeight(height)

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

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

المعلمات

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

الإرجاع

Line: عنصر الصفحة هذا، ويُستخدم في الربط.

التفويض

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

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

setLeft(left)

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

المعلمات

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

الإرجاع

Line: عنصر الصفحة هذا، ويُستخدم في الربط.

التفويض

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

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

setLineCategory(lineCategory)

تضبط هذه السمة LineCategory للخط.

يمكنك ضبط الفئة على connectors فقط. قد تتم إعادة توجيه الموصل بعد تغيير فئته.

المعلمات

الاسمالنوعالوصف
lineCategoryLineCategoryتمثّل هذه السمة فئة السطر المطلوب ضبطها.

الإرجاع

Line — الخط

التفويض

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

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

الإرجاع

Line: عنصر الصفحة هذا، ويُستخدم في الربط.

التفويض

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

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

setStart(left, top)

تضبط هذه السمة موضع نقطة بداية الخط.

يمكن تعديل مسار الخط بعد تغيير الموضع.

المعلمات

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

الإرجاع

Line: هذا السطر مخصّص للربط.

التفويض

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

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

setStart(point)

تضبط هذه السمة موضع نقطة بداية الخط.

يمكن تعديل مسار الخط بعد تغيير الموضع.

المعلمات

الاسمالنوعالوصف
pointPointتمثّل هذه السمة نقطة بداية الخط، ويتم قياس موضعها من أعلى يمين الصفحة.

الإرجاع

Line: هذا السطر مخصّص للربط.

التفويض

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

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

setStartArrow(style)

تضبط هذه السمة ArrowStyle السهم في بداية السطر.

المعلمات

الاسمالنوعالوصف
styleArrowStyleنمط السهم الجديد الذي تريد ضبطه

الإرجاع

Line: هذا السطر مخصّص للربط.

التفويض

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

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

setStartConnection(connectionSite)

تضبط هذه السمة موضع الاتصال في بداية السطر. ويؤدي ذلك إلى نقل بداية الخط إلى موقع الربط المحدّد مع الحفاظ على الطرف الآخر.

المعلمات

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

الإرجاع

Line — الخط

التفويض

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

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

الإرجاع

Line: عنصر الصفحة هذا

التفويض

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

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

setTop(top)

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

المعلمات

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

الإرجاع

Line: عنصر الصفحة هذا، ويُستخدم في الربط.

التفويض

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

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

setTransform(transform)

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

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

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

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

المعلمات

الاسمالنوعالوصف
transformAffineTransformتمثّل هذه السمة عملية التحويل التي تم ضبطها لعنصر الصفحة هذا.

الإرجاع

‫Line: هذا العنصر مخصّص للربط.

التفويض

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

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

setWeight(points)

تضبط هذه السمة سمك الخط بالنقاط.

المعلمات

الاسمالنوعالوصف
pointsNumberتمثّل هذه السمة السماكة الجديدة للخط بالنقاط.

الإرجاع

Line: هذا السطر مخصّص للربط.

التفويض

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

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

setWidth(width)

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

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

المعلمات

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

الإرجاع

Line: عنصر الصفحة هذا، ويُستخدم في الربط.

التفويض

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

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