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

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

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

المَعلمات

الاسم	النوع	الوصف
`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()`

لعرض قائمة من 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

`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