تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class Line

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

الطُرق

الطريقة	نوع الإرجاع	وصف قصير
`alignOnPage(alignmentPosition)`	`Line`	لمحاذاة العنصر مع موضع المحاذاة المحدد على الصفحة.
`bringForward()`	`Line`	لإحضار عنصر الصفحة إلى الأمام في الصفحة بواسطة عنصر واحد.
`bringToFront()`	`Line`	لنقل عنصر الصفحة إلى مقدّمة الصفحة.
`duplicate()`	`PageElement`	يؤدي هذا الإجراء إلى تكرار عنصر الصفحة.
`getConnectionSites()`	`ConnectionSite[]`	يتم عرض قائمة `ConnectionSite`s في عنصر الصفحة أو قائمة فارغة إذا لم يتضمّن عنصر الصفحة أي مواقع اتصال.
`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)`

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

المعلمات

الاسم	النوع	الوصف
`alignmentPosition`	`AlignmentPosition`	الموضع الذي يجب محاذاة عنصر الصفحة هذا معه على الصفحة.

الإرجاع

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

`getLink()`

تعرض 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 إذا لم يكن كذلك.

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

الإرجاع

Boolean — True إذا كان الخط موصلاً، أو 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).

المعلمات

الاسم	النوع	الوصف
`transform`	`AffineTransform`	التحويل لإجراء تسلسل مسبق لتحويل عنصر هذه الصفحة.

الإرجاع

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

`removeLink()`

ستتم إزالة Link.

shape.removeLink();

`reroute()`

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

الإرجاع

Line — السطر.

التفويض

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

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

`scaleHeight(ratio)`

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

المعلمات

الاسم	النوع	الوصف
`ratio`	`Number`	يشير ذلك المصطلح إلى النسبة المستخدمة في قياس ارتفاع عنصر الصفحة هذا.

الإرجاع

Line — عنصر الصفحة هذا، للتسلسل.

التفويض

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

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

`scaleWidth(ratio)`

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

المعلمات

الاسم	النوع	الوصف
`ratio`	`Number`	يشير ذلك المصطلح إلى النسبة المستخدَمة لقياس عرض عنصر الصفحة هذا.

الإرجاع

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:

يجب أن يكون العنصر الرئيسي Page للعنصر PageElement هو current page selection.
يجب عدم اختيار عدة عناصر "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);
}

المعلمات

الاسم	النوع	الوصف
`replace`	`Boolean`	إذا كانت القيمة `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 من السطر.

المعلمات

الاسم	النوع	الوصف
`style`	`DashStyle`	نمط الشَرطة المطلوب ضبطها لهذا الخط.

الإرجاع

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

المعلمات

الاسم	النوع	الوصف
`description`	`String`	السلسلة المطلوب تعيين وصف النص البديل إليها.

الإرجاع

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

التفويض

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

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

`setEnd(left, top)`

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

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

المعلمات

الاسم	النوع	الوصف
`left`	`Number`	الموضع الأفقي لنقطة نهاية الخط، ويتم قياسه بالنقاط بدءًا من أعلى يسار الصفحة.
`top`	`Number`	الموضع العمودي لنقطة نهاية الخط، ويتم قياسه بالنقاط من أعلى يسار الصفحة.

الإرجاع

Line — هذا الخط للسلسلة.

التفويض

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

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

`setEnd(point)`

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

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

المعلمات

الاسم	النوع	الوصف
`point`	`Point`	تمثّل هذه السمة نقطة نهاية الخط التي يتم قياس موضعها من أعلى يسار الصفحة.

الإرجاع

Line — هذا الخط للسلسلة.

التفويض

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

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

`setEndArrow(style)`

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

المعلمات

الاسم	النوع	الوصف
`style`	`ArrowStyle`	النمط المطلوب تعيينه.

الإرجاع

Line — هذا الخط للسلسلة.

التفويض

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

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

`setEndConnection(connectionSite)`

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

المعلمات

الاسم	النوع	الوصف
`connectionSite`	`ConnectionSite`	موقع الاتصال الذي تم تعديل الاتصال النهائي إليه، أو `null` في حال إزالة الاتصال النهائي.

الإرجاع

Line — السطر.

التفويض

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

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

`setHeight(height)`

لتعيين ارتفاع العنصر بالنقاط، وهو ارتفاع مربع إحاطة العنصر عندما لا يكون له دوران.

المعلمات

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

الإرجاع

Line — عنصر الصفحة هذا، للتسلسل.

التفويض

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

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

`setLeft(left)`

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

المعلمات

الاسم	النوع	الوصف
`left`	`Number`	الموضع الأفقي الجديد الذي يجب تحديده بالنقاط.

الإرجاع

Line — عنصر الصفحة هذا، للتسلسل.

التفويض

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

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

`setLineCategory(lineCategory)`

لضبط LineCategory من السطر.

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

المعلمات

الاسم	النوع	الوصف
`lineCategory`	`LineCategory`	فئة الخط المطلوب ضبطها.

الإرجاع

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

المعلمات

الاسم	النوع	الوصف
`slideIndex`	`Integer`	الفهرس القائم على صفر للشريحة.

الإرجاع

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

المعلمات

الاسم	النوع	الوصف
`slide`	`Slide`	`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.
shape.setLinkSlide(SlideApp.SlidePosition.FIRST_SLIDE);

المعلمات

الاسم	النوع	الوصف
`slidePosition`	`SlidePosition`	تمثّل هذه السمة `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");

المعلمات

الاسم	النوع	الوصف
`url`	`String`	سلسلة عنوان URL.

الإرجاع

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

التفويض

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

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

`setRotation(angle)`

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

المعلمات

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

الإرجاع

Line — عنصر الصفحة هذا، للتسلسل.

التفويض

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

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

`setStart(left, top)`

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

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

المعلمات

الاسم	النوع	الوصف
`left`	`Number`	الموضع الأفقي لنقطة بداية الخط، ويتم قياسه بالنقاط بدءًا من أعلى يسار الصفحة.
`top`	`Number`	الموضع العمودي لنقطة بداية الخط، ويتم قياسه بالنقاط بدءًا من أعلى يسار الصفحة.

الإرجاع

Line — هذا الخط للسلسلة.

التفويض

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

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

`setStart(point)`

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

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

المعلمات

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

الإرجاع

Line — هذا الخط للسلسلة.

التفويض

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

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

`setStartArrow(style)`

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

المعلمات

الاسم	النوع	الوصف
`style`	`ArrowStyle`	نمط السهم الجديد المطلوب تعيينه.

الإرجاع

Line — هذا الخط للسلسلة.

التفويض

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

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

`setStartConnection(connectionSite)`

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

المعلمات

الاسم	النوع	الوصف
`connectionSite`	`ConnectionSite`	موقع الاتصال الذي تم تعديل اتصال البدء إليه، أو `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());

المعلمات

الاسم	النوع	الوصف
`title`	`String`	السلسلة المطلوب تعيين عنوان النص البديل إليها.

الإرجاع

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

التفويض

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

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

`setTop(top)`

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

المعلمات

الاسم	النوع	الوصف
`top`	`Number`	الموضع العمودي الجديد الذي يجب تحديده بالنقاط

الإرجاع

Line — عنصر الصفحة هذا، للتسلسل.

التفويض

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

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

`setTransform(transform)`

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

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

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

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

المعلمات

الاسم	النوع	الوصف
`transform`	`AffineTransform`	التحويل الذي يتم تعيينه لعنصر الصفحة هذا.

الإرجاع

Line — هذا العنصر، للتسلسل.

التفويض

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

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

`setWeight(points)`

لضبط سُمك الخط بالنقاط.

المعلمات

الاسم	النوع	الوصف
`points`	`Number`	السماكة الجديدة للخط بالنقاط.

الإرجاع

Line — هذا الخط للسلسلة.

التفويض

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

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

`setWidth(width)`

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

المعلمات

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

الإرجاع

Line — عنصر الصفحة هذا، للتسلسل.

التفويض

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

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