Class Line

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

تمثّل هذه السمة PageElement خطًا.

الطُرق

الطريقةنوع الإرجاعوصف قصير
alignOnPage(alignmentPosition)Lineلمحاذاة العنصر مع موضع المحاذاة المحدد في الصفحة.
bringForward()Lineلجلب عنصر الصفحة للأمام على الصفحة بواسطة عنصر واحد.
bringToFront()Lineلجلب عنصر الصفحة إلى مقدمة الصفحة.
duplicate()PageElementتكرار عنصر الصفحة.
getConnectionSites()ConnectionSite[]لعرض قائمة من ConnectionSite في عنصر الصفحة، أو قائمة فارغة إذا لم يكن عنصر الصفحة يحتوي على أي مواقع اتصال.
getDashStyle()DashStyleللحصول على DashStyle من السطر.
getDescription()Stringلعرض وصف النص البديل لعنصر الصفحة.
getEnd()Pointلعرض نقطة نهاية السطر، ويتم قياسها من الركن العلوي الأيمن من الصفحة.
getEndArrow()ArrowStyleللحصول على ArrowStyle من السهم في نهاية السطر.
getEndConnection()ConnectionSiteلعرض الاتصال في نهاية السطر، أو null في حالة عدم وجود اتصال.
getHeight()Numberللحصول على ارتفاع العنصر بالنقاط، وهو ارتفاع مربع إحاطة العنصر عند عدم تدوير العنصر.
getInherentHeight()Numberلعرض الارتفاع الأصيل للعنصر بالنقاط.
getInherentWidth()Numberلعرض العرض الأصيل للعنصر بالنقاط.
getLeft()Numberلعرض الموضع الأفقي للعنصر بالنقاط، ويتم قياسه من الزاوية العلوية اليمنى للصفحة عندما لا يكون العنصر يدور.
getLineCategory()LineCategoryللحصول على LineCategory من السطر.
getLineFill()LineFillللحصول على LineFill من السطر.
getLineType()LineTypeللحصول على LineType من السطر.
getLink()Linkلعرض Link أو null إذا لم يكن هناك رابط.
getObjectId()Stringلعرض المعرّف الفريد لهذا الكائن.
getPageElementType()PageElementTypeلعرض نوع عنصر الصفحة، ممثلًا كتعداد PageElementType.
getParentGroup()Groupلعرض المجموعة التي ينتمي إليها عنصر الصفحة هذا، أو null إذا لم يكن العنصر في مجموعة.
getParentPage()Pageلعرض الصفحة حيث يوجد عنصر الصفحة هذا.
getRotation()Numberلعرض زاوية دوران عقارب الساعة للعنصر حول مركزه بالدرجات، حيث تعني الصفر صفرًا عدم التدوير.
getStart()Pointلعرض نقطة بداية السطر، يتم قياسها من الركن العلوي الأيمن من الصفحة.
getStartArrow()ArrowStyleللحصول على ArrowStyle من السهم في بداية السطر.
getStartConnection()ConnectionSiteلعرض الاتصال في بداية السطر، أو null في حالة عدم وجود اتصال.
getTitle()Stringلعرض عنوان النص البديل لعنصر الصفحة.
getTop()Numberللحصول على الموضع الرأسي للعنصر بنقاط، ويتم قياسه من الركن العلوي الأيمن من الصفحة عندما لا يكون العنصر يدور.
getTransform()AffineTransformلعرض تحويل عنصر الصفحة.
getWeight()Numberلعرض سُمك الخط بالنقاط.
getWidth()Numberلعرض عرض العنصر بالنقاط، وهو عرض مربع الإحاطة للعنصر عندما لا يكون العنصر له تدوير.
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()

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

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

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 — الاتصال بنهاية السطر.

التفويض

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

  • 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

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 إذا لم يكن هناك رابط.

var link = shape.getLink();
if (link != null) {
  Logger.log('Shape has a link of type: ' + link.getLinkType());
}

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

Link

التفويض

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

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

getObjectId()

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

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

String — المعرّف الفريد لهذا الكائن.

التفويض

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

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

getPageElementType()

لعرض نوع عنصر الصفحة، ممثلًا كتعداد PageElementType.

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

PageElementType — نوع عنصر الصفحة.

التفويض

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

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

getParentGroup()

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

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

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

التفويض

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

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

getParentPage()

لعرض الصفحة حيث يوجد عنصر الصفحة هذا.

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

Page — الصفحة التي يوجد بها هذا العنصر.

التفويض

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

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

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 — الاتصال في بداية السطر.

التفويض

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

  • 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 إذا لم يكن لعنصر الصفحة عرض.

التفويض

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

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

isConnector()

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

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

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

BooleanTrue إذا كان الخط هو موصل، أو false إذا لم يكن كذلك.

التفويض

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

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

preconcatenateTransform(transform)

يعمل هذا الإعداد على تسلسل النقل المُقدَّم للتحول الحالي لعنصر الصفحة.

newTransform = argument * existingTransform

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

element.preconcatenateTransform(SlidesApp.newAffineTransformBuilder()
    .setTranslateX(-36.0)
    .build());

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

المَعلمات

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

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

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.

shape.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.

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

التفويض

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

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

select(replace)

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

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

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

مرِّر false لاختيار عدة كائنات PageElement. يجب أن تكون الكائنات PageElement في Page نفسها.

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

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

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

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

المَعلمات

الاسمالنوعالوصف
replaceBooleanإذا تم تحديد true، سيحل التحديد محل أي اختيار سابق، وإلا ستتم إضافة الاختيار إلى أي اختيار سابق.

التفويض

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

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

sendBackward()

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

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

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

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".
var 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.
shape.setLinkSlide(0);

المَعلمات

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

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

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

التفويض

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

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

setLinkSlide(slide)

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

// Set a link to the first slide of the presentation.
var slide = presentation.getSlides()[0];
shape.setLinkSlide(slide);

المَعلمات

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

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

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

التفويض

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

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

setLinkSlide(slidePosition)

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

// Set a link to the first slide of the presentation.
shape.setLinkSlide(SlideApp.SlidePosition.FIRST_SLIDE);

المَعلمات

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

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

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

التفويض

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

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

setLinkUrl(url)

لضبط Link على سلسلة عنوان URL غير فارغة.

// Set a link to the URL.
shape.setLinkUrl("https://slides.google.com");

المَعلمات

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

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

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

التفويض

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

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

setRotation(angle)

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

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

المَعلمات

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

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

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 في حال إزالة الاتصال المبدئي.

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

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".
var 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