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

Class Table

PageElement يمثّل جدولاً.

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
`alignOnPage(alignmentPosition)`	`Table`	محاذاة العنصر مع موضع المحاذاة المحدّد على الصفحة
`appendColumn()`	`TableColumn`	إلحاق عمود جديد على يسار آخر عمود في الجدول
`appendRow()`	`TableRow`	إلحاق صف جديد أسفل الصف الأخير من الجدول
`bringForward()`	`Table`	ينقل عنصر الصفحة إلى الأمام في الصفحة بعنصر واحد.
`bringToFront()`	`Table`	تنقل عنصر الصفحة إلى مقدمة الصفحة.
`duplicate()`	`PageElement`	تكرار عنصر الصفحة
`getCell(rowIndex, columnIndex)`	`TableCell`	لعرض الخلية المحدّدة في الجدول.
`getColumn(columnIndex)`	`TableColumn`	لعرض العمود المحدّد في الجدول.
`getConnectionSites()`	`ConnectionSite[]`	تعرِض هذه السمة قائمة المواقع الإلكترونية التي ترتبط بها الصفحة، أو قائمة فارغة إذا لم يكن عنصر الصفحة يتضمّن أي مواقع إلكترونية مرتبطة.`ConnectionSite`
`getDescription()`	`String`	تعرِض هذه السمة وصف النص البديل لعنصر الصفحة.
`getHeight()`	`Number`	تحصل على ارتفاع العنصر بالنقاط، وهو ارتفاع مربّع حدود العنصر عندما لا يكون العنصر مُدرَجًا.
`getInherentHeight()`	`Number`	تعرِض هذه الدالة الارتفاع الأساسي للعنصر بالنقاط.
`getInherentWidth()`	`Number`	لعرض العرض الأساسي للعنصر بالنقاط.
`getLeft()`	`Number`	تعرِض هذه السمة موضع العنصر الأفقي بالنقاط، ويتم قياسه من أعلى يمين الصفحة عندما لا يكون العنصر مُدارًا.
`getNumColumns()`	`Integer`	لعرض عدد الأعمدة في الجدول.
`getNumRows()`	`Integer`	تعرِض هذه الدالة عدد الصفوف في الجدول.
`getObjectId()`	`String`	تعرِض هذه السمة المعرّف الفريد لهذا العنصر.
`getPageElementType()`	`PageElementType`	لعرض نوع عنصر الصفحة، الذي يتم تمثيله كقائمة `PageElementType`.
`getParentGroup()`	`Group`	تعرِض هذه السمة المجموعة التي ينتمي إليها عنصر الصفحة، أو `null` إذا لم يكن العنصر في مجموعة.
`getParentPage()`	`Page`	تعرِض هذه السمة الصفحة التي يظهر عليها عنصر الصفحة.
`getRotation()`	`Number`	تعرض هذه الدالة زاوية دوران العنصر في اتجاه عقارب الساعة حول مركزه بالدرجات، حيث تعني درجة الصفر عدم التدوير.
`getRow(rowIndex)`	`TableRow`	لعرض الصف المحدّد في الجدول.
`getTitle()`	`String`	عرض عنوان النص البديل لعنصر الصفحة
`getTop()`	`Number`	تحصل على موضع العنصر العمودي بالنقاط، ويتم قياسه من الزاوية العلوية اليسرى من الصفحة عندما لا يكون العنصر مُدارًا.
`getTransform()`	`AffineTransform`	لعرض تحويل عنصر الصفحة.
`getWidth()`	`Number`	عرض العنصر بالنقاط، وهو عرض مربّع حدود العنصر عندما لا يكون العنصر مُدارًا
`insertColumn(index)`	`TableColumn`	تُستخدَم هذه الدالة لإدراج عمود جديد في الفهرس المحدّد للجدول.
`insertRow(index)`	`TableRow`	تُستخدَم هذه الدالة لإدراج صف جديد في الفهرس المحدّد للجدول.
`preconcatenateTransform(transform)`	`Table`	تسلسل مسبق للتحويل المقدَّم مع التحويل الحالي لعنصر الصفحة
`remove()`	`void`	تزيل عنصر الصفحة.
`scaleHeight(ratio)`	`Table`	تُحوِّل هذه الوظيفة ارتفاع العنصر إلى نسبة محدّدة.
`scaleWidth(ratio)`	`Table`	تُحوِّل هذه السمة عرض العنصر إلى نسبة محدّدة.
`select()`	`void`	لتحديد `PageElement` فقط في العرض النشط وإزالة أي تحديد سابق
`select(replace)`	`void`	يختار `PageElement` في العرض التقديمي النشط.
`sendBackward()`	`Table`	ينقل عنصر الصفحة للخلف في الصفحة بعنصر واحد.
`sendToBack()`	`Table`	تُرسِل عنصر الصفحة إلى الجزء الخلفي من الصفحة.
`setDescription(description)`	`Table`	لضبط وصف النص البديل لعنصر الصفحة
`setHeight(height)`	`Table`	تُستخدَم لضبط ارتفاع العنصر بالنقاط، وهو ارتفاع مربّع حدود العنصر عندما لا يكون العنصر مُدرَجًا.
`setLeft(left)`	`Table`	تُستخدَم لضبط موضع العنصر الأفقي بالنقاط، ويتم قياسها من أعلى يمين الصفحة عندما لا يكون العنصر مُدارًا.
`setRotation(angle)`	`Table`	لضبط زاوية دوران العنصر في اتجاه عقارب الساعة حول مركزه بالدرجات
`setTitle(title)`	`Table`	تُستخدَم لضبط عنوان النص البديل لعنصر الصفحة.
`setTop(top)`	`Table`	تُستخدَم لضبط موضع العنصر العمودي بالنقاط، ويتم قياسه من الزاوية العلوية اليسرى من الصفحة عندما لا يكون العنصر مُدارًا.
`setTransform(transform)`	`Table`	تُستخدَم لضبط التحويل لعنصر الصفحة باستخدام التحويل المقدَّم.
`setWidth(width)`	`Table`	تُستخدَم لضبط عرض العنصر بالنقاط، وهو عرض مربّع حدود العنصر عندما لا يكون العنصر مُدرَجًا.

مستندات تفصيلية

`alignOnPage(alignmentPosition)`

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

المعلمات

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

الإرجاع

‫Table: عنصر الصفحة هذا، لتسلسل العناصر

`appendColumn()`

إلحاق عمود جديد على يسار آخر عمود في الجدول

الإرجاع

TableColumn: العمود الجديد المُضاف.

التفويض

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

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

`appendRow()`

إلحاق صف جديد أسفل الصف الأخير من الجدول

الإرجاع

TableRow: الصف الجديد المُضاف.

التفويض

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

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

`bringForward()`

ينقل عنصر الصفحة إلى الأمام في الصفحة بعنصر واحد.

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

الإرجاع

‫Table: عنصر الصفحة هذا، لتسلسل العناصر

التفويض

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

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

`bringToFront()`

تنقل عنصر الصفحة إلى مقدمة الصفحة.

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

الإرجاع

‫Table: عنصر الصفحة هذا، لتسلسل العناصر

التفويض

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

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

`getCell(rowIndex, columnIndex)`

لعرض الخلية المحدّدة في الجدول.

المعلمات

الاسم	النوع	الوصف
`rowIndex`	`Integer`	فهرس صف الخلية المطلوب استرجاعها
`columnIndex`	`Integer`	فهرس عمود الخلية المطلوب استرجاعها

الإرجاع

TableCell - تم استرداد خلية الجدول.

التفويض

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

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

`getColumn(columnIndex)`

لعرض العمود المحدّد في الجدول.

المعلمات

الاسم	النوع	الوصف
`columnIndex`	`Integer`	فهرس العمود ابتداءً من 0

الإرجاع

TableColumn: عمود الجدول الذي تم استرجاعه

التفويض

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

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

`getDescription()`

تعرِض هذه السمة وصف النص البديل لعنصر الصفحة. يتم دمج الوصف مع العنوان لأجل عرض النص البديل وقراءته.

الإرجاع

String: وصف النص البديل لعنصر الصفحة

التفويض

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

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

`getNumColumns()`

لعرض عدد الأعمدة في الجدول.

الإرجاع

Integer: عدد الأعمدة في هذا الجدول

التفويض

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

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

`getNumRows()`

تعرِض هذه الدالة عدد الصفوف في الجدول.

الإرجاع

Integer: عدد الصفوف في هذا الجدول

التفويض

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

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

`getRow(rowIndex)`

لعرض الصف المحدّد في الجدول.

المعلمات

الاسم	النوع	الوصف
`rowIndex`	`Integer`	فهرس الصف الذي تريد استرجاعه.

الإرجاع

TableRow - تم استرجاع صف الجدول.

التفويض

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

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

`getWidth()`

عرض العنصر بالنقاط، وهو عرض مربّع حدود العنصر عندما لا يكون العنصر مُدارًا

الإرجاع

‫Number: العرض التلقائي لعنصر الصفحة بالنقاط، أو null إذا لم يكن لعنصر الصفحة عرض

التفويض

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

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

`insertColumn(index)`

تُستخدَم هذه الدالة لإدراج عمود جديد في الفهرس المحدّد للجدول.

إذا تم دمج كل الخلايا في العمود على يمين الفهرس المحدّد مع غيرها من الأعمدة، يتم إدراج العمود الجديد على يمين الأعمدة المشتركة التي تمتد إليها هذه الخلايا.

المعلمات

الاسم	النوع	الوصف
`index`	`Integer`	الفهرس الذي سيتم إدراج عمود جديد فيه

الإرجاع

TableColumn: العمود الجديد الذي تم إدراجه

التفويض

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

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

`insertRow(index)`

تُستخدَم هذه الدالة لإدراج صف جديد في الفهرس المحدّد للجدول.

إذا تم دمج جميع الخلايا في الصف فوق الفهرس المحدّد مع صفوف أخرى، يتم إدراج الصف الجديد تحت الصفوف المشتركة التي تمتد إليها هذه الخلايا.

المعلمات

الاسم	النوع	الوصف
`index`	`Integer`	الفهرس الذي سيتم إدراج صف جديد فيه

الإرجاع

TableRow: الصف الجديد الذي تم إدراجه

التفويض

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

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

`preconcatenateTransform(transform)`

تسلسل مسبق للتحويل المقدَّم مع التحويل الحالي لعنصر الصفحة

newTransform = argument * existingTransform;

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

const element = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
element.preconcatenateTransform(
    SlidesApp.newAffineTransformBuilder().setTranslateX(-36.0).build(),
);

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

المعلمات

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

الإرجاع

‫Table: عنصر الصفحة هذا، لتسلسل العناصر

التفويض

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

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

`scaleHeight(ratio)`

تُحوِّل هذه الوظيفة ارتفاع العنصر إلى نسبة محدّدة. ارتفاع العنصر هو ارتفاع حدوده عندما لا يكون العنصر مُدارًا.

المعلمات

الاسم	النوع	الوصف
`ratio`	`Number`	النسبة التي يتم بها تغيير ارتفاع عنصر الصفحة هذا.

الإرجاع

‫Table: عنصر الصفحة هذا، لتسلسل العناصر

التفويض

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

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

`scaleWidth(ratio)`

تُحوِّل هذه السمة عرض العنصر إلى نسبة محدّدة. عرض العنصر هو عرض حدوده عندما لا يكون العنصر مُدارًا.

المعلمات

الاسم	النوع	الوصف
`ratio`	`Number`	النسبة التي يتم بها تغيير حجم عرض عنصر الصفحة هذا.

الإرجاع

‫Table: عنصر الصفحة هذا، لتسلسل العناصر

التفويض

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

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

`select()`

لتحديد PageElement فقط في العرض النشط وإزالة أي تحديد سابق وهذا يعادل استدعاء select(replace) باستخدام true.

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

يؤدي ذلك إلى ضبط العنصر الرئيسي Page للعنصر PageElement على أنّه 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)`

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

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

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

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

يجب أن يكون العنصر الرئيسي Page لكائن PageElement هو 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

`sendBackward()`

ينقل عنصر الصفحة للخلف في الصفحة بعنصر واحد.

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

الإرجاع

‫Table: عنصر الصفحة هذا، لتسلسل العناصر

التفويض

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

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

`sendToBack()`

تُرسِل عنصر الصفحة إلى الجزء الخلفي من الصفحة.

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

الإرجاع

‫Table: عنصر الصفحة هذا، لتسلسل العناصر

التفويض

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

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".
const pageElement =
    SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setDescription('new alt text description');
Logger.log(pageElement.getDescription());

المعلمات

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

الإرجاع

Table: عنصر الصفحة هذا.

التفويض

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

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

`setHeight(height)`

تُستخدَم لضبط ارتفاع العنصر بالنقاط، وهو ارتفاع مربّع حدود العنصر عندما لا يكون العنصر مُدرَجًا.

المعلمات

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

الإرجاع

‫Table: عنصر الصفحة هذا، لتسلسل العناصر

التفويض

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

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

`setLeft(left)`

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

المعلمات

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

الإرجاع

‫Table: عنصر الصفحة هذا، لتسلسل العناصر

التفويض

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

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

`setRotation(angle)`

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

المعلمات

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

الإرجاع

‫Table: عنصر الصفحة هذا، لتسلسل العناصر

التفويض

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

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".
const pageElement =
    SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setTitle('new alt text title');
Logger.log(pageElement.getTitle());

المعلمات

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

الإرجاع

Table: عنصر الصفحة هذا.

التفويض

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

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

`setTop(top)`

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

المعلمات

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

الإرجاع

‫Table: عنصر الصفحة هذا، لتسلسل العناصر

التفويض

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

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

`setTransform(transform)`

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

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

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

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

المعلمات

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

الإرجاع

Table: هذا العنصر مخصّص للتسلسل.

التفويض

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

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

`setWidth(width)`

تُستخدَم لضبط عرض العنصر بالنقاط، وهو عرض مربّع حدود العنصر عندما لا يكون العنصر مُدرَجًا.

المعلمات

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

الإرجاع

‫Table: عنصر الصفحة هذا، لتسلسل العناصر

التفويض

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

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