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 إذا لم يكن هناك اتصال.
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()

عرض قائمة 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 — الاتصال الموجود في نهاية السطر.

التفويض

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

  • 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الفهرس القائم على صفر للشريحة.

الإرجاع

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.
var slide = presentation.getSlides()[0];
shape.setLinkSlide(slide);

المعلمات

الاسمالنوعالوصف
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.
shape.setLinkSlide(SlideApp.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.
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 في حالة إزالة اتصال البدء.

الإرجاع

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