Page يمثّل سطرًا.
الطُرق
| الطريقة | نوع القيمة التي يتم عرضها | وصف قصير | 
|---|---|---|
| align | Line | محاذاة العنصر مع موضع المحاذاة المحدّد على الصفحة | 
| bring | Line | ينقل عنصر الصفحة إلى الأمام في الصفحة بعنصر واحد. | 
| bring | Line | تنقل عنصر الصفحة إلى مقدمة الصفحة. | 
| duplicate() | Page | تكرار عنصر الصفحة | 
| get | Connection | تعرِض هذه السمة قائمة المواقع الإلكترونية التي ترتبط بها الصفحة، أو قائمة فارغة إذا لم يكن عنصر
الصفحة يتضمّن أي مواقع إلكترونية مرتبطة. Connection | 
| get | Dash | تحصل على Dashمن السطر. | 
| get | String | تعرِض هذه السمة وصف النص البديل لعنصر الصفحة. | 
| get | Point | لعرض نقطة نهاية الخط، يتم قياسها من أعلى يمين الصفحة. | 
| get | Arrow | تحصل على Arrowالسهم في نهاية السطر. | 
| get | Connection | تعرِض هذه السمة الاتصال في نهاية السطر، أو nullفي حال عدم توفّر اتصال. | 
| get | Number | تحصل على ارتفاع العنصر بالنقاط، وهو ارتفاع مربّع حدود العنصر عندما لا يكون العنصر مُدرَجًا. | 
| get | Number | تعرِض هذه الدالة الارتفاع الأساسي للعنصر بالنقاط. | 
| get | Number | لعرض العرض الأساسي للعنصر بالنقاط. | 
| get | Number | تعرِض هذه السمة موضع العنصر الأفقي بالنقاط، ويتم قياسه من أعلى يمين الصفحة عندما لا يكون العنصر مُدارًا. | 
| get | Line | تحصل على Lineمن السطر. | 
| get | Line | تحصل على Lineمن السطر. | 
| get | Line | تحصل على Lineمن السطر. | 
| get | Link | تعرِض القيمة Linkأوnullفي حال عدم توفّر رابط. | 
| get | String | تعرِض هذه السمة المعرّف الفريد لهذا العنصر. | 
| get | Page | لعرض نوع عنصر الصفحة، الذي يتم تمثيله كقائمة Page. | 
| get | Group | تعرِض هذه السمة المجموعة التي ينتمي إليها عنصر الصفحة، أو nullإذا لم يكن العنصر في مجموعة. | 
| get | Page | تعرِض هذه السمة الصفحة التي يظهر عليها عنصر الصفحة. | 
| get | Number | تعرض هذه الدالة زاوية دوران العنصر في اتجاه عقارب الساعة حول مركزه بالدرجات، حيث تعني درجة الصفر عدم التدوير. | 
| get | Point | لعرض نقطة بداية السطر، يتم قياسها من أعلى يمين الصفحة. | 
| get | Arrow | تحصل على Arrowللسهم في بداية السطر. | 
| get | Connection | عرض علامة الربط في بداية السطر، أو nullفي حال عدم توفّر علامة ربط | 
| get | String | عرض عنوان النص البديل لعنصر الصفحة | 
| get | Number | تحصل على موضع العنصر العمودي بالنقاط، ويتم قياسه من الزاوية العلوية اليسرى من الصفحة عندما لا يكون العنصر مُدارًا. | 
| get | Affine | لعرض تحويل عنصر الصفحة. | 
| get | Number | لعرض سمك الخط بالنقاط. | 
| get | Number | تُعرِض هذه السمة عرض العنصر بالنقاط، وهو عرض مربّع حدود العنصر عندما لا يكون العنصر مُدرَجًا. | 
| is | Boolean | تعرِض القيمة trueإذا كان السطر موصّلاً، أوfalseإذا لم يكن كذلك. | 
| preconcatenate | Line | تسلسل مسبق للتحويل المقدَّم مع التحويل الحالي لعنصر الصفحة | 
| remove() | void | تزيل عنصر الصفحة. | 
| remove | void | إزالة Link | 
| reroute() | Line | إعادة توجيه بداية السطر ونهايته إلى أقرب موقعَي اتصال في عناصر الصفحة المرتبطة | 
| scale | Line | تُحوِّل هذه السمة ارتفاع العنصر إلى نسبة محدّدة. | 
| scale | Line | تُحوِّل هذه السمة عرض العنصر إلى نسبة محدّدة. | 
| select() | void | لتحديد Pageفقط في العرض النشط وإزالة أي تحديد سابق | 
| select(replace) | void | يختار Pageفي العرض التقديمي النشط. | 
| send | Line | ينقل عنصر الصفحة للخلف في الصفحة بعنصر واحد. | 
| send | Line | تُرسِل عنصر الصفحة إلى الجزء الخلفي من الصفحة. | 
| set | Line | لضبط Dashللخط | 
| set | Line | لضبط وصف النص البديل لعنصر الصفحة | 
| set | Line | لضبط موضع نقطة نهاية الخط | 
| set | Line | لضبط موضع نقطة نهاية الخط | 
| set | Line | لضبط Arrowللسهم في نهاية السطر | 
| set | Line | لضبط الربط في نهاية السطر | 
| set | Line | تُستخدَم لضبط ارتفاع العنصر بالنقاط، وهو ارتفاع مربّع حدود العنصر عندما لا يكون العنصر مُدرَجًا. | 
| set | Line | تُستخدَم لضبط موضع العنصر الأفقي بالنقاط، ويتم قياسها من أعلى يمين الصفحة عندما لا يكون العنصر مُدارًا. | 
| set | Line | لضبط Lineللخط | 
| set | Link | تُستخدَم هذه الدالة لضبط LinkعلىSlideالمحدَّد باستخدام الفهرس المستند إلى الصفر للشريحة. | 
| set | Link | تُستخدَم لضبط LinkعلىSlideالمحدَّد، ويتم ضبط الرابط باستخدام معرّف الشريحة المحدَّد. | 
| set | Link | تُستخدَم هذه الدالة لضبط LinkعلىSlideالمحدّد باستخدام الموضع النسبي للشريحة. | 
| set | Link | تُحدِّد Linkلسلسلة عنوان URL غير الفارغة المحدّدة. | 
| set | Line | لضبط زاوية دوران العنصر في اتجاه عقارب الساعة حول مركزه بالدرجات | 
| set | Line | لتحديد موضع نقطة بداية الخط | 
| set | Line | لتحديد موضع نقطة بداية الخط | 
| set | Line | لضبط Arrowللسهم في بداية السطر | 
| set | Line | لضبط الربط في بداية السطر | 
| set | Line | تُستخدَم لضبط عنوان النص البديل لعنصر الصفحة. | 
| set | Line | تُستخدَم لضبط موضع العنصر العمودي بالنقاط، ويتم قياسه من الزاوية العلوية اليسرى من الصفحة عندما لا يكون العنصر مُدرَجًا. | 
| set | Line | تُستخدَم لضبط التحويل لعنصر الصفحة باستخدام التحويل المقدَّم. | 
| set | Line | لضبط سمك الخط بالنقاط | 
| set | Line | تُستخدَم لضبط عرض العنصر بالنقاط، وهو عرض مربّع حدود العنصر عندما لا يكون العنصر مُدرَجًا. | 
مستندات تفصيلية
align
محاذاة العنصر مع موضع المحاذاة المحدّد على الصفحة
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| alignment | Alignment | الموضع الذي سيتم محاذاة عنصر الصفحة هذا عليه في الصفحة. | 
الإرجاع
Line: عنصر الصفحة هذا، لإنشاء سلسلة.
bring
ينقل عنصر الصفحة إلى الأمام في الصفحة بعنصر واحد.
يجب ألا يكون عنصر الصفحة في مجموعة.
الإرجاع
Line: عنصر الصفحة هذا، لإنشاء سلسلة.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
bring
تنقل عنصر الصفحة إلى مقدمة الصفحة.
يجب ألا يكون عنصر الصفحة في مجموعة.
الإرجاع
Line: عنصر الصفحة هذا، لإنشاء سلسلة.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
duplicate()
تكرار عنصر الصفحة
يتم وضع عنصر الصفحة المكرّر في الصفحة نفسها وفي الموضع نفسه الذي يظهر فيه العنصر الأصلي.
الإرجاع
Page: النسخة الجديدة من عنصر الصفحة هذا.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
get
تعرِض هذه السمة قائمة المواقع الإلكترونية التي ترتبط بها الصفحة، أو قائمة فارغة إذا لم يكن عنصر
الصفحة يتضمّن أي مواقع إلكترونية مرتبطة.Connection
الإرجاع
Connection: قائمة المواقع الإلكترونية المرتبطة، والتي قد تكون فارغة إذا لم يكن لهذا العنصر مواقع إلكترونية مرتبطة.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
get
تحصل على Dash من السطر.
الإرجاع
Dash - نمط الخطوط المتقطّعة المستخدَمة مع هذا السطر.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
get
تعرِض هذه السمة وصف النص البديل لعنصر الصفحة. يتم دمج الوصف مع العنوان لأجل عرض النص البديل وقراءته.
الإرجاع
String: وصف النص البديل لعنصر الصفحة
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
get
get
تحصل على Arrow السهم في نهاية السطر.
الإرجاع
Arrow - أسلوب السهم في نهاية هذا السطر.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
get
تعرِض هذه السمة الاتصال في نهاية السطر، أو null في حال عدم توفّر اتصال.
الإرجاع
Connection: علامة الربط في نهاية السطر
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
get
تحصل على ارتفاع العنصر بالنقاط، وهو ارتفاع مربّع حدود العنصر عندما لا يكون العنصر مُدرَجًا.
لا تتوافق هذه الطريقة مع جميع عناصر الصفحة. للتعرّف على عناصر الصفحة التي لا تتماشى مع هذه الطريقة، يُرجى الاطّلاع على قيود الحجم والموضع.
الإرجاع
Number: الارتفاع الأساسي لعنصر الصفحة بالنقاط، أو null إذا لم يكن لعنصر الصفحة
    ارتفاع
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
get
تعرِض هذه الدالة الارتفاع الأساسي للعنصر بالنقاط.
يكون تحويل عنصر الصفحة نسبيًا لحجمه الأساسي. استخدِم الحجم الأساسي بالاشتراك مع التحويل الخاص بالعنصر لتحديد المظهر المرئي النهائي للعنصر.
الإرجاع
Number: الارتفاع الأساسي لعنصر الصفحة بالنقاط، أو null إذا لم يكن لعنصر الصفحة
    ارتفاع
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
get
لعرض العرض الأساسي للعنصر بالنقاط.
يكون تحويل عنصر الصفحة نسبيًا لحجمه الأساسي. استخدِم الحجم الأساسي بالاشتراك مع التحويل الخاص بالعنصر لتحديد المظهر المرئي النهائي للعنصر.
الإرجاع
Number: العرض التلقائي لعنصر الصفحة بالنقاط، أو null إذا لم يكن لعنصر الصفحة
    عرض
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
get
تعرِض هذه السمة موضع العنصر الأفقي بالنقاط، ويتم قياسه من أعلى يمين الصفحة عندما لا يكون العنصر مُدارًا.
الإرجاع
Number: موضع هذا العنصر الأفقي بالنقاط، من أعلى يمين الصفحة
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
get
تحصل على Line من السطر.
الإرجاع
Line: فئة السطر.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
get
get
get
تعرِض القيمة Link أو null في حال عدم توفّر رابط.
const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0]; const link = shape.getLink(); if (link != null) { Logger.log(`Shape has a link of type: ${link.getLinkType()}`); }
الإرجاع
Link: Link أو null في حال عدم توفّر رابط
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
get
تعرِض هذه السمة المعرّف الفريد لهذا العنصر. تشترك أرقام تعريف الكائنات التي تستخدمها الصفحات وعناصر الصفحات في مساحة الاسم نفسها.
الإرجاع
String: المعرّف الفريد لهذا العنصر.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
get
لعرض نوع عنصر الصفحة، الذي يتم تمثيله كقائمة Page.
الإرجاع
Page: نوع عنصر الصفحة
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
get
تعرِض هذه السمة المجموعة التي ينتمي إليها عنصر الصفحة، أو null إذا لم يكن العنصر في مجموعة.
الإرجاع
Group: المجموعة التي ينتمي إليها عنصر الصفحة، أو null
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
get
تعرِض هذه السمة الصفحة التي يظهر عليها عنصر الصفحة.
الإرجاع
Page: الصفحة التي يقع عليها هذا العنصر
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
get
تعرض هذه الدالة زاوية دوران العنصر في اتجاه عقارب الساعة حول مركزه بالدرجات، حيث تعني درجة الصفر عدم التدوير.
الإرجاع
Number: زاوية الدوران بالدرجات بين 0 (شامل) و360 (مانع)
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
get
get
تحصل على Arrow للسهم في بداية السطر.
الإرجاع
Arrow - أسلوب السهم في بداية هذا السطر.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
get
عرض علامة الربط في بداية السطر، أو null في حال عدم توفّر علامة ربط
الإرجاع
Connection — الربط في بداية السطر
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
get
عرض عنوان النص البديل لعنصر الصفحة يتم دمج العنوان مع الوصف لأجل عرض النص البديل وقراءته.
الإرجاع
String: عنوان النص البديل لعنصر الصفحة.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
get
تحصل على موضع العنصر العمودي بالنقاط، ويتم قياسه من الزاوية العلوية اليسرى من الصفحة عندما لا يكون العنصر مُدارًا.
الإرجاع
Number: موضع هذا العنصر العمودي بالنقاط، من أعلى يمين الصفحة
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
get
لعرض تحويل عنصر الصفحة.
يتم تحديد المظهر المرئي لعنصر الصفحة من خلال التحويل المطلق. لحساب التحويل المطلق، يجب تسلسل تحويل عنصر الصفحة مسبقًا مع عمليات التحويل الخاصة بكل المجموعات الرئيسية. إذا لم يكن عنصر الصفحة في مجموعة، تكون التحويلة المطلقة له هي نفسها القيمة الواردة في هذا الحقل.
الإرجاع
Affine: تحويل عنصر الصفحة
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
get
لعرض سمك الخط بالنقاط.
الإرجاع
Number: سمك الخط بالنقاط
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
get
تُعرِض هذه السمة عرض العنصر بالنقاط، وهو عرض مربّع حدود العنصر عندما لا يكون العنصر مُدرَجًا.
لا تتوافق هذه الطريقة مع جميع عناصر الصفحة. للتعرّف على عناصر الصفحة التي لا تتماشى مع هذه الطريقة، يُرجى الاطّلاع على قيود الحجم والموضع.
الإرجاع
Number: العرض التلقائي لعنصر الصفحة بالنقاط، أو null إذا لم يكن لعنصر الصفحة
    عرض
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
is
تعرِض القيمة true إذا كان السطر موصّلاً، أو false إذا لم يكن كذلك.
الموصّل هو نوع من الخطوط المستخدَمة لربط المواقع الإلكترونية المرتبطة في عناصر الصفحة السارية. يمكن توصيل كل طرف من الموصّل بموقع ربط واحد بحد أقصى.
الإرجاع
Boolean: True إذا كان السطر موصلاً، أو false إذا لم يكن كذلك
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
preconcatenate
تسلسل مسبق للتحويل المقدَّم مع التحويل الحالي لعنصر الصفحة
newTransform = argument * existingTransform; 
على سبيل المثال، لنقل عنصر صفحة 36 نقطة إلى اليسار:
const element = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0]; element.preconcatenateTransform( SlidesApp.newAffineTransformBuilder().setTranslateX(-36.0).build(), );
يمكنك أيضًا استبدال عملية التحويل الخاصة بعنصر الصفحة بـ set.
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| transform | Affine | عملية التحويل التي يتمّ تسلسلها مسبقًا مع عملية تحويل عنصر الصفحة هذا. | 
الإرجاع
Line: عنصر الصفحة هذا، لإنشاء سلسلة.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
remove()
تزيل عنصر الصفحة.
إذا كانت Group تحتوي بعد عملية إزالة على عنصر صفحة واحد فقط أو لا تحتوي على أي عناصر، تتم أيضًا إزالة
المجموعة نفسها.
في حال إزالة عنصر نائب Page في نموذج أساسي أو تنسيق، تتم أيضًا إزالة أي عناصر نائبة فارغة ترث
العناصر النائبة.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
remove
إزالة Link
const slides = SlidesApp.getActivePresentation().getSlides(); slides[1].getShapes()[0].removeLink();
reroute()
إعادة توجيه بداية السطر ونهايته إلى أقرب موقعَي اتصال في عناصر الصفحة المرتبطة يجب أن يكون بدء السطر وانتهاؤه مرتبطَين بعناصر صفحة مختلفة.
الإرجاع
Line: الخط
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
scale
تُحوِّل هذه السمة ارتفاع العنصر إلى نسبة محدّدة. ارتفاع العنصر هو ارتفاع حدوده عندما لا يكون العنصر مُدرَجًا.
لا تتوافق هذه الطريقة مع جميع عناصر الصفحة. للتعرّف على عناصر الصفحة التي لا تتماشى مع هذه الطريقة، يُرجى الاطّلاع على قيود الحجم والموضع.
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| ratio | Number | النسبة التي يتم بها تغيير ارتفاع عنصر الصفحة هذا. | 
الإرجاع
Line: عنصر الصفحة هذا، لإنشاء سلسلة.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
scale
تُحوِّل هذه السمة عرض العنصر إلى نسبة محدّدة. عرض العنصر هو عرض حدوده عندما لا يكون العنصر مُدرَجًا.
لا تتوافق هذه الطريقة مع جميع عناصر الصفحة. للتعرّف على عناصر الصفحة التي لا تتماشى مع هذه الطريقة، يُرجى الاطّلاع على قيود الحجم والموضع.
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| ratio | Number | النسبة التي يتم بها تغيير حجم عرض عنصر الصفحة هذا | 
الإرجاع
Line: عنصر الصفحة هذا، لإنشاء سلسلة.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
select()
لتحديد Page فقط في العرض النشط وإزالة أي تحديد سابق
 وهذا يعادل استدعاء select(replace) باستخدام true.
لا يمكن للنص البرمجي الوصول إلى اختيار المستخدم الذي يشغّل النص البرمجي إلا إذا كان مرتبطًا بالعرض التقديمي.
يؤدي ذلك إلى ضبط العنصر الرئيسي Page للعنصر Page على أنّه current page selection.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; const pageElement = slide.getPageElements()[0]; // Only select this page element and replace any previous selection. pageElement.select();
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
select(replace)
يختار Page في العرض التقديمي النشط.
لا يمكن للنص البرمجي الوصول إلى اختيار المستخدم الذي يشغّل النص البرمجي إلا إذا كان مرتبطًا بالعرض التقديمي.
مرِّر true إلى هذه الطريقة لاختيار Page فقط وإزالة أي
اختيار سابق. يؤدي ذلك أيضًا إلى ضبط العنصر الرئيسي Page للعنصر Page على أنّه
current page selection.
مرِّر مؤشر الماوس فوق false لاختيار عدة عناصر Page. يجب أن تكون عناصر Page
في Page نفسه.
يجب استيفاء الشروط التالية أثناء اختيار عنصر صفحة باستخدام مَعلمة false:
- يجب أن يكون العنصر الرئيسي PageلكائنPageهوElement current page selection.
- يجب عدم اختيار عناصر Pageمتعددة.
للتأكّد من ذلك، يُفضّل اختيار العنصر الرئيسي Page
أولًا باستخدام Page.selectAsCurrentPage() ثم اختيار عناصر الصفحة في تلك الصفحة.
const slide = SlidesApp.getActivePresentation().getSlides()[0]; // First select the slide page, as the current page selection. slide.selectAsCurrentPage(); // Then select all the page elements in the selected slide page. const pageElements = slide.getPageElements(); for (let i = 0; i < pageElements.length; i++) { pageElements[i].select(false); }
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| replace | Boolean | إذا كان الخيار true، سيحلّ الاختيار محلّ أي اختيار سابق، وإلا تتم إضافة
    اختيار إلى أي اختيار سابق. | 
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
send
ينقل عنصر الصفحة للخلف في الصفحة بعنصر واحد.
يجب ألا يكون عنصر الصفحة في مجموعة.
الإرجاع
Line: عنصر الصفحة هذا، لإنشاء سلسلة.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
send
تُرسِل عنصر الصفحة إلى الجزء الخلفي من الصفحة.
يجب ألا يكون عنصر الصفحة في مجموعة.
الإرجاع
Line: عنصر الصفحة هذا، لإنشاء سلسلة.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
set
لضبط Dash للخط
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| style | Dash | أسلوب الخطوط المقطوعة التي سيتم ضبطها لهذا السطر. | 
الإرجاع
Line - هذا السطر مخصّص لإنشاء سلاسل.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
set
لضبط وصف النص البديل لعنصر الصفحة
الطريقة غير متاحة لعناصر Group.
// Set the first page element's alt text description to "new alt text // description". const pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0]; pageElement.setDescription('new alt text description'); Logger.log(pageElement.getDescription());
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| description | String | السلسلة التي سيتم ضبط وصف النص البديل عليها. | 
الإرجاع
Line: عنصر الصفحة هذا.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
set
لضبط موضع نقطة نهاية الخط
قد يتم تعديل مسار الخط بعد تغيير الموضع.
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| left | Number | الموضع الأفقي لنقطة نهاية الخط، ويتم قياسه بالنقاط من أعلى يمين الصفحة. | 
| top | Number | الموضع العمودي لنقطة نهاية الخط، ويتم قياسه بالنقاط من أعلى يمين الصفحة. | 
الإرجاع
Line - هذا السطر مخصّص لإنشاء سلاسل.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
set
لضبط موضع نقطة نهاية الخط
قد يتم تعديل مسار الخط بعد تغيير الموضع.
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| point | Point | نقطة نهاية الخط، ويتم قياس موضعها من أعلى يمين الصفحة. | 
الإرجاع
Line - هذا السطر مخصّص لإنشاء سلاسل.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
set
لضبط Arrow للسهم في نهاية السطر
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| style | Arrow | الطراز المطلوب ضبطه | 
الإرجاع
Line - هذا السطر مخصّص لإنشاء سلاسل.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
set
لضبط الاتصال في نهاية السطر وينقل نهاية السطر إلى موقع الربط المحدّد مع إبقاء الطرف الآخر سليمًا.
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| connection | Connection | موقع الربط الذي يتم تعديل الاتصال النهائي عليه، أو nullفي حال
    إزالة الاتصال النهائي. | 
الإرجاع
Line: الخط
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
set
تُستخدَم لضبط ارتفاع العنصر بالنقاط، وهو ارتفاع مربّع حدود العنصر عندما لا يكون العنصر مُدرَجًا.
لا تتوافق هذه الطريقة مع جميع عناصر الصفحة. للتعرّف على عناصر الصفحة التي لا تتماشى مع هذه الطريقة، يُرجى الاطّلاع على قيود الحجم والموضع.
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| height | Number | الارتفاع الجديد لعنصر الصفحة المطلوب ضبطه، بالنقاط | 
الإرجاع
Line: عنصر الصفحة هذا، لإنشاء سلسلة.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
set
تُستخدَم لضبط موضع العنصر الأفقي بالنقاط، ويتم قياسها من أعلى يمين الصفحة عندما لا يكون العنصر مُدارًا.
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| left | Number | الموضع الأفقي الجديد المطلوب ضبطه، بالنقاط | 
الإرجاع
Line: عنصر الصفحة هذا، لإنشاء سلسلة.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
set
لضبط Line للخط
يمكنك ضبط الفئة على connectors فقط. قد تتم إعادة توجيه الموصّل
بعد تغيير فئته.
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| line | Line | فئة السطر المطلوب ضبطها. | 
الإرجاع
Line: الخط
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
set
تُستخدَم هذه الدالة لضبط Link على Slide المحدَّد باستخدام الفهرس المستند إلى الصفر للشريحة.
// Set a link to the first slide of the presentation. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkSlide(0);
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| slide | Integer | الفهرس الذي يبدأ من الصفر للشريحة | 
الإرجاع
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
set
تُستخدَم لضبط Link على Slide المحدَّد، ويتم ضبط الرابط باستخدام معرّف الشريحة المحدَّد.
// Set a link to the first slide of the presentation. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkSlide(slides[0]);
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| slide | Slide | Slideالمطلوب ربطه | 
الإرجاع
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
set
تُستخدَم هذه الدالة لضبط Link على Slide المحدّد باستخدام الموضع النسبي للشريحة.
// Set a link to the first slide of the presentation. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| slide | Slide | " Slide" النسبي | 
الإرجاع
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
set
تُحدِّد Link لسلسلة عنوان URL غير الفارغة المحدّدة.
// Set a link to the URL. const slides = SlidesApp.getActivePresentation().getSlides(); const shape = slides[1].getShapes()[0]; const link = shape.setLinkUrl('https://slides.google.com');
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| url | String | سلسلة عنوان URL | 
الإرجاع
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
set
لضبط زاوية دوران العنصر في اتجاه عقارب الساعة حول مركزه بالدرجات
لا تتوافق هذه الطريقة مع جميع عناصر الصفحة. للتعرّف على عناصر الصفحة التي لا تتماشى مع هذه الطريقة، يُرجى الاطّلاع على قيود الحجم والموضع.
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| angle | Number | زاوية الدوران الجديدة في اتجاه عقارب الساعة التي سيتم ضبطها، بالدرجات | 
الإرجاع
Line: عنصر الصفحة هذا، لإنشاء سلسلة.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
set
لتحديد موضع نقطة بداية الخط
قد يتم تعديل مسار الخط بعد تغيير الموضع.
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| left | Number | الموضع الأفقي لنقطة بداية الخط، ويتم قياسه بالنقاط من الزاوية العلوية اليسرى من الصفحة. | 
| top | Number | الموضع العمودي لنقطة بداية الخط، ويتم قياسه بالنقاط من أعلى يمين الصفحة. | 
الإرجاع
Line - هذا السطر مخصّص لإنشاء سلاسل.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
set
لتحديد موضع نقطة بداية الخط
قد يتم تعديل مسار الخط بعد تغيير الموضع.
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| point | Point | نقطة بداية الخط، ويتم قياس موضعها من أعلى يمين الصفحة. | 
الإرجاع
Line - هذا السطر مخصّص لإنشاء سلاسل.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
set
لضبط Arrow للسهم في بداية السطر
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| style | Arrow | نمط السهم الجديد المطلوب ضبطه | 
الإرجاع
Line - هذا السطر مخصّص لإنشاء سلاسل.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
set
لضبط الربط في بداية السطر وينقل بداية السطر إلى الموقع الإلكتروني المحدّد للربط مع إبقاء الطرف الآخر سليمًا.
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| connection | Connection | موقع الاتصال الذي يتم تعديل اتصال البداية عليه، أو nullفي حال إزالة اتصال البداية | 
الإرجاع
Line: الخط
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
set
تُستخدَم لضبط عنوان النص البديل لعنصر الصفحة.
الطريقة غير متاحة لعناصر Group.
// Set the first page element's alt text title to "new alt text title". const pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0]; pageElement.setTitle('new alt text title'); Logger.log(pageElement.getTitle());
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| title | String | السلسلة التي سيتم ضبط عنوان النص البديل عليها. | 
الإرجاع
Line: عنصر الصفحة هذا.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
set
تُستخدَم لضبط موضع العنصر العمودي بالنقاط، ويتم قياسه من الزاوية العلوية اليسرى من الصفحة عندما لا يكون العنصر مُدرَجًا.
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| top | Number | الموضع العمودي الجديد المطلوب ضبطه، بالنقاط | 
الإرجاع
Line: عنصر الصفحة هذا، لإنشاء سلسلة.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
set
تُستخدَم لضبط التحويل لعنصر الصفحة باستخدام التحويل المقدَّم.
يؤدي تعديل التحويل لمجموعة إلى تغيير التحويل المطلق لعناصر الصفحة في هذه المجموعة، ما قد يؤدي إلى تغيير مظهرها المرئي.
يؤدي تعديل التحويل لعنصر صفحة ضمن مجموعة إلى تغيير تحويل هذا العنصر فقط، ولا يؤثّر في عمليات التحويل للمجموعة أو عناصر الصفحة الأخرى في المجموعة.
لمعرفة التفاصيل عن كيفية تأثير عمليات التحويل في المظهر المرئي لعناصر الصفحة، يُرجى الاطّلاع على get.
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| transform | Affine | عملية التحويل التي تم ضبطها لعنصر الصفحة هذا. | 
الإرجاع
Line: هذا العنصر مخصّص للتسلسل.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
set
لضبط سمك الخط بالنقاط
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| points | Number | السماكة الجديدة للخط بالنقاط | 
الإرجاع
Line - هذا السطر مخصّص لإنشاء سلاسل.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations
set
تُستخدَم لضبط عرض العنصر بالنقاط، وهو عرض مربّع حدود العنصر عندما لا يكون العنصر مُدرَجًا.
لا تتوافق هذه الطريقة مع جميع عناصر الصفحة. للتعرّف على عناصر الصفحة التي لا تتماشى مع هذه الطريقة، يُرجى الاطّلاع على قيود الحجم والموضع.
المعلمات
| الاسم | النوع | الوصف | 
|---|---|---|
| width | Number | العرض الجديد لعنصر الصفحة المطلوب ضبطه، بالنقاط | 
الإرجاع
Line: عنصر الصفحة هذا، لإنشاء سلسلة.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
- 
https://www.googleapis.com/auth/presentations.currentonly
- 
https://www.googleapis.com/auth/presentations