تمثّل هذه السمة PageElement
خطًا.
الطُرق
الطريقة | نوع الإرجاع | وصف قصير |
---|---|---|
alignOnPage(alignmentPosition) | Line | لمحاذاة العنصر مع موضع المحاذاة المحدد على الصفحة. |
bringForward() | Line | لإحضار عنصر الصفحة إلى الأمام في الصفحة بواسطة عنصر واحد. |
bringToFront() | Line | لنقل عنصر الصفحة إلى مقدّمة الصفحة. |
duplicate() | PageElement | يؤدي هذا الإجراء إلى تكرار عنصر الصفحة. |
getConnectionSites() | ConnectionSite[] | عرض قائمة ConnectionSite s على عنصر الصفحة، أو قائمة فارغة إذا كانت الصفحة
لا يحتوي على أي مواقع اتصال. |
getDashStyle() | DashStyle | الحصول على DashStyle من السطر. |
getDescription() | String | تعرض وصف النص البديل لعنصر الصفحة. |
getEnd() | Point | تعرض نقطة نهاية الخط، والتي يتم قياسها من الزاوية العلوية اليسرى من الصفحة. |
getEndArrow() | ArrowStyle | الحصول على ArrowStyle للسهم في نهاية السطر |
getEndConnection() | ConnectionSite | لعرض الاتصال في نهاية السطر، أو null إذا لم يكن هناك اتصال. |
getHeight() | Number | للحصول على ارتفاع العنصر بالنقاط، وهو ارتفاع مربع إحاطة العنصر عند لا يحتوي العنصر على تدوير. |
getInherentHeight() | Number | تعرض الارتفاع الكامن للعنصر بالنقاط. |
getInherentWidth() | Number | لعرض العرض الكامن للعنصر بالنقاط. |
getLeft() | Number | لعرض الموضع الأفقي للعنصر بالنقاط، والتي يتم قياسها من الزاوية العليا اليسرى عندما لا يحتوي العنصر على تدوير. |
getLineCategory() | LineCategory | الحصول على LineCategory من السطر. |
getLineFill() | LineFill | الحصول على LineFill من السطر. |
getLineType() | LineType | الحصول على LineType من السطر. |
getLink() | Link | تعرض Link أو null في حال عدم توفّر رابط. |
getObjectId() | String | تعرض المعرّف الفريد لهذا العنصر. |
getPageElementType() | PageElementType | عرض نوع عنصر الصفحة، ويتم تمثيله كتعداد PageElementType . |
getParentGroup() | Group | عرض المجموعة التي ينتمي إليها عنصر الصفحة هذا، أو null إذا لم يكن العنصر في
المجموعة. |
getParentPage() | Page | لعرض الصفحة التي يوجد بها عنصر الصفحة هذا. |
getRotation() | Number | عرض زاوية تدوير العنصر في اتجاه عقارب الساعة حول مركزه بالدرجات، حيث تكون صفر درجة لا يعني الدوران. |
getStart() | Point | تعرض نقطة بداية الخط، والتي يتم قياسها من الزاوية العلوية اليسرى من الصفحة. |
getStartArrow() | ArrowStyle | الحصول على ArrowStyle للسهم في بداية السطر |
getStartConnection() | ConnectionSite | يعرض الرابط في بداية السطر، أو null إذا لم يكن هناك اتصال. |
getTitle() | String | تعرض عنوان النص البديل لعنصر الصفحة. |
getTop() | Number | الحصول على الموضع الرأسي للعنصر بالنقاط، ويتم قياسه من الزاوية العلوية اليسرى من الصفحة عندما لا يحتوي العنصر على تدوير. |
getTransform() | AffineTransform | لعرض تحويل عنصر الصفحة. |
getWeight() | Number | لعرض سُمك الخط بالنقاط. |
getWidth() | Number | يتم عرض عرض العنصر بالنقاط، وهو عرض مربع إحاطة العنصر عندما فلن يحتوي العنصر على تدوير. |
isConnector() | Boolean | عرض true إذا كان الخط موصلاً، أو false إذا لم يكن كذلك. |
preconcatenateTransform(transform) | Line | إنشاء تسلسل مسبق لعملية التحويل المتوفرة لعملية التحويل الحالية لعنصر الصفحة. |
remove() | void | لإزالة عنصر الصفحة. |
removeLink() | void | ستتم إزالة Link . |
reroute() | Line | لإعادة توجيه بداية الخط ونهايته إلى أقرب موقعين للاتصال في المنطقة المتصلة عناصر الصفحة. |
scaleHeight(ratio) | Line | تعمل على قياس ارتفاع العنصر بنسبة محددة. |
scaleWidth(ratio) | Line | تعمل هذه السمة على زيادة عرض العنصر وفقًا للنسبة المحددة. |
select() | void | يؤدي هذا الإجراء إلى اختيار PageElement فقط في العرض التقديمي النشط وإزالة أي عناصر سابقة.
التحديد. |
select(replace) | void | لاختيار "PageElement " في العرض التقديمي النشط |
sendBackward() | Line | لإعادة عنصر الصفحة إلى الخلف في الصفحة بواسطة عنصر واحد. |
sendToBack() | Line | لإرسال عنصر الصفحة إلى الجزء الخلفي من الصفحة |
setDashStyle(style) | Line | لضبط DashStyle من السطر. |
setDescription(description) | Line | لضبط وصف النص البديل لعنصر الصفحة. |
setEnd(left, top) | Line | لتعيين موضع نقطة نهاية الخط. |
setEnd(point) | Line | لتعيين موضع نقطة نهاية الخط. |
setEndArrow(style) | Line | لضبط ArrowStyle للسهم في نهاية السطر. |
setEndConnection(connectionSite) | Line | لضبط الاتصال في نهاية السطر |
setHeight(height) | Line | لتعيين ارتفاع العنصر بالنقاط، وهو ارتفاع مربع إحاطة العنصر عند لا يحتوي العنصر على تدوير. |
setLeft(left) | Line | لتعيين الموضع الأفقي للعنصر، بالنقاط، التي يتم قياسها من الزاوية العلوية اليسرى من عندما لا يحتوي العنصر على تدوير. |
setLineCategory(lineCategory) | Line | لضبط LineCategory من السطر. |
setLinkSlide(slideIndex) | Link | لضبط Link على Slide المحدّد باستخدام فهرس الشريحة الصفرية |
setLinkSlide(slide) | Link | لضبط Link على Slide المحدّد، يتم ضبط الرابط من خلال رقم تعريف الشريحة المحدّد. |
setLinkSlide(slidePosition) | Link | لضبط Link على Slide المحدّد باستخدام الموضع النسبي للشريحة |
setLinkUrl(url) | Link | تضبط Link على سلسلة عنوان URL غير الفارغة المحدّدة. |
setRotation(angle) | Line | تضبط زاوية تدوير العنصر في اتجاه عقارب الساعة حول مركزه بالدرجات. |
setStart(left, top) | Line | لتعيين موضع نقطة بداية الخط. |
setStart(point) | Line | لتعيين موضع نقطة بداية الخط. |
setStartArrow(style) | Line | لضبط ArrowStyle للسهم في بداية السطر. |
setStartConnection(connectionSite) | Line | لضبط الاتصال في بداية السطر. |
setTitle(title) | Line | لتعيين عنوان النص البديل لعنصر الصفحة. |
setTop(top) | Line | يضبط الموضع الرأسي للعنصر بالنقاط، ويتم قياسه من الزاوية العلوية اليسرى من الصفحة. عندما لا يحتوي العنصر على تدوير. |
setTransform(transform) | Line | لضبط تحويل عنصر الصفحة باستخدام التحويل المتوفر. |
setWeight(points) | Line | لضبط سُمك الخط بالنقاط. |
setWidth(width) | Line | لتعيين عرض العنصر بالنقاط، وهو عرض مربع إحاطة العنصر عندما لا يحتوي العنصر على تدوير. |
الوثائق التفصيلية
alignOnPage(alignmentPosition)
لمحاذاة العنصر مع موضع المحاذاة المحدد على الصفحة.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
alignmentPosition | AlignmentPosition | الموضع الذي يجب محاذاة عنصر الصفحة هذا معه على الصفحة. |
الإرجاع
Line
— عنصر الصفحة هذا، للتسلسل.
bringForward()
لإحضار عنصر الصفحة إلى الأمام في الصفحة بواسطة عنصر واحد.
يجب ألا يكون عنصر الصفحة في مجموعة.
الإرجاع
Line
— عنصر الصفحة هذا، للتسلسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
bringToFront()
لنقل عنصر الصفحة إلى مقدّمة الصفحة.
يجب ألا يكون عنصر الصفحة في مجموعة.
الإرجاع
Line
— عنصر الصفحة هذا، للتسلسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
duplicate()
يؤدي هذا الإجراء إلى تكرار عنصر الصفحة.
يتم وضع عنصر الصفحة المكررة في الصفحة نفسها في نفس موضع العنصر الأصلي.
الإرجاع
PageElement
— النسخة المكررة الجديدة لعنصر الصفحة هذا.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getConnectionSites()
عرض قائمة ConnectionSite
s على عنصر الصفحة، أو قائمة فارغة إذا كانت الصفحة
لا يحتوي على أي مواقع اتصال.
الإرجاع
ConnectionSite[]
: قائمة المواقع الإلكترونية للاتصال، وقد تكون فارغة إذا لم يكن لهذا العنصر مواقع اتصال
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getDashStyle()
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()
getLineType()
getLink()
تعرض Link
أو null
في حال عدم توفّر رابط.
var link = shape.getLink(); if (link != null) { Logger.log('Shape has a link of type: ' + link.getLinkType()); }
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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 | الفهرس القائم على صفر للشريحة. |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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 المطلوب ربطه |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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 النسبي. |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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. |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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