تمثّل هذه السمة PageElement
شكلاً عامًا لا يتضمّن تصنيفًا أكثر تحديدًا. وتتضمن مربعات النص والمستطيلات والأشكال الأخرى المحددة مسبقًا.
الطُرق
الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
---|---|---|
alignOnPage(alignmentPosition) | Shape | لمحاذاة العنصر مع موضع المحاذاة المحدد على الصفحة |
bringForward() | Shape | لإحضار عنصر الصفحة إلى الأمام على الصفحة بمقدار عنصر واحد. |
bringToFront() | Shape | لإحضار عنصر الصفحة إلى مقدمة الصفحة. |
duplicate() | PageElement | يكرّر عنصر الصفحة. |
getAutofit() | Autofit | يتم عرض Autofit للنص داخل هذا الشكل. |
getBorder() | Border | تعرض Border للشكل. |
getConnectionSites() | ConnectionSite[] | عرض قائمة ConnectionSite s على عنصر الصفحة، أو عرض قائمة فارغة إذا لم يكن عنصر الصفحة يحتوي على أي مواقع ربط. |
getContentAlignment() | ContentAlignment | لعرض ContentAlignment للنص في الشكل. |
getDescription() | String | لعرض وصف النص البديل لعنصر الصفحة. |
getFill() | Fill | تعرض Fill للشكل. |
getHeight() | Number | للحصول على ارتفاع العنصر بالنقاط، وهو ارتفاع مربّع إحاطة العنصر عندما لا يكون له دوران. |
getInherentHeight() | Number | لعرض الارتفاع المتأصل في العنصر بالنقاط. |
getInherentWidth() | Number | لعرض العرض المتأصل للعنصر بالنقاط. |
getLeft() | Number | يتم عرض الموضع الأفقي للعنصر بالنقاط، ويتم قياسه من الزاوية العلوية اليسرى للصفحة عندما لا يكون للعنصر دوران. |
getLink() | Link | تعرض Link أو null في حال عدم توفّر رابط. |
getObjectId() | String | يعرض المُعرّف الفريد لهذا العنصر. |
getPageElementType() | PageElementType | لعرض نوع عنصر الصفحة، ويتم تمثيله بالتعداد PageElementType . |
getParentGroup() | Group | لعرض المجموعة التي ينتمي إليها عنصر الصفحة هذا أو null إذا لم يكن العنصر في مجموعة. |
getParentPage() | Page | لعرض الصفحة التي يوجد بها عنصر الصفحة هذا. |
getParentPlaceholder() | PageElement | لعرض عنصر الصفحة الرئيسية للعنصر النائب. |
getPlaceholderIndex() | Integer | لعرض فهرس العنصر النائب للشكل. |
getPlaceholderType() | PlaceholderType | يتم عرض نوع العنصر النائب للشكل أو PlaceholderType.NONE إذا لم يكن الشكل عنصرًا نائبًا. |
getRotation() | Number | يتم عرض زاوية الدوران في اتجاه عقارب الساعة للعنصر حول مركزه بالدرجات، حيث تعني الدرجة صفر عدم الدوران. |
getShapeType() | ShapeType | تعرض نوع الشكل. |
getText() | TextRange | لعرض المحتوى النصي للشكل. |
getTitle() | String | لعرض عنوان النص البديل لعنصر الصفحة. |
getTop() | Number | للحصول على الموضع الرأسي للعنصر بالنقاط، يتم قياسه من الزاوية العلوية اليسرى للصفحة عندما لا يكون للعنصر دوران. |
getTransform() | AffineTransform | لعرض تحويل عنصر الصفحة. |
getWidth() | Number | لعرض عرض العنصر بالنقاط، وهو عرض مربع إحاطة العنصر عندما لا يكون له دوران. |
preconcatenateTransform(transform) | Shape | يربط التحويل المقدم مسبقًا بالتحويل الحالي لعنصر الصفحة. |
remove() | void | لإزالة عنصر الصفحة. |
removeLink() | void | إزالة Link |
replaceWithImage(blobSource) | Image | يستبدل هذا الشكل بصورة مقدّمة من BlobSource . |
replaceWithImage(blobSource, crop) | Image | يستبدل هذا الشكل بصورة مقدّمة من BlobSource . |
replaceWithImage(imageUrl) | Image | يستبدل هذا الشكل بصورة. |
replaceWithImage(imageUrl, crop) | Image | يستبدل هذا الشكل بصورة. |
replaceWithSheetsChart(sourceChart) | SheetsChart | يستبدل هذا الشكل بمخطط جداول بيانات Google. |
replaceWithSheetsChartAsImage(sourceChart) | Image | يستبدل هذا الشكل بصورة رسم بياني في "جداول بيانات Google". |
scaleHeight(ratio) | Shape | لتحجيم ارتفاع العنصر حسب النسبة المحددة. |
scaleWidth(ratio) | Shape | لتحجيم عرض العنصر حسب النسبة المحددة. |
select() | void | اختيار PageElement فقط في العرض التقديمي النشط وإزالة أي اختيار سابق |
select(replace) | void | لاختيار PageElement في العرض التقديمي النشط. |
sendBackward() | Shape | لإعادة عنصر الصفحة إلى الخلف على الصفحة بواسطة عنصر واحد. |
sendToBack() | Shape | لإرسال عنصر الصفحة إلى الجزء الخلفي من الصفحة. |
setContentAlignment(contentAlignment) | Shape | ضبط ContentAlignment للنص في الشكل. |
setDescription(description) | Shape | لضبط وصف النص البديل لعنصر الصفحة. |
setHeight(height) | Shape | لتعيين ارتفاع العنصر بالنقاط، وهو ارتفاع مربع إحاطة العنصر عندما لا يكون له دوران. |
setLeft(left) | Shape | لتحديد الموضع الأفقي للعنصر بالنقاط، ويتم قياسه من الزاوية العلوية اليسرى للصفحة عندما لا يكون للعنصر أي دوران. |
setLinkSlide(slideIndex) | Link | لضبط Link على Slide المحددة باستخدام الفهرس المستند إلى الصفر للشريحة |
setLinkSlide(slide) | Link | لضبط Link على Slide المحدَّد، يتم ضبط الرابط من خلال رقم تعريف الشريحة المحدّد. |
setLinkSlide(slidePosition) | Link | لضبط Link على Slide المحددة باستخدام الموضع النسبي للشريحة. |
setLinkUrl(url) | Link | لضبط Link على سلسلة عنوان URL غير الفارغة المحددة |
setRotation(angle) | Shape | لضبط زاوية تدوير العنصر في اتجاه عقارب الساعة حول مركزه بالدرجات. |
setTitle(title) | Shape | لضبط عنوان النص البديل لعنصر الصفحة. |
setTop(top) | Shape | لضبط الموضع الرأسي للعنصر بالنقاط، يتم قياسه من الزاوية العلوية اليسرى للصفحة عندما لا يكون للعنصر دوران. |
setTransform(transform) | Shape | لضبط تحويل عنصر الصفحة مع التحويل المقدم. |
setWidth(width) | Shape | لتعيين عرض العنصر بالنقاط، وهو عرض مربع إحاطة العنصر عندما لا يكون للعنصر دوران. |
الوثائق التفصيلية
alignOnPage(alignmentPosition)
لمحاذاة العنصر مع موضع المحاذاة المحدد على الصفحة
المَعلمات
الاسم | Type | الوصف |
---|---|---|
alignmentPosition | AlignmentPosition | موضع محاذاة عنصر الصفحة هذا مع الصفحة. |
استرجاع الكرة
Shape
- عنصر الصفحة هذا للسلاسل
bringForward()
لإحضار عنصر الصفحة إلى الأمام على الصفحة بمقدار عنصر واحد.
يجب ألا يكون عنصر الصفحة في مجموعة.
استرجاع الكرة
Shape
- عنصر الصفحة هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
bringToFront()
لإحضار عنصر الصفحة إلى مقدمة الصفحة.
يجب ألا يكون عنصر الصفحة في مجموعة.
استرجاع الكرة
Shape
- عنصر الصفحة هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
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
getAutofit()
يتم عرض Autofit
للنص داخل هذا الشكل. هذه القيمة null
إذا كان
الشكل لا يسمح بالنص.
استرجاع الكرة
Autofit
- الاحتواء التلقائي للنص داخل هذا الشكل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getBorder()
getConnectionSites()
عرض قائمة ConnectionSite
s على عنصر الصفحة، أو عرض قائمة فارغة إذا لم يكن عنصر الصفحة يحتوي على أي مواقع ربط.
استرجاع الكرة
ConnectionSite[]
- قائمة مواقع الاتصال، والتي قد تكون فارغة إذا لم يكن لهذا العنصر أي مواقع ربط
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getContentAlignment()
لعرض ContentAlignment
للنص في الشكل.
استرجاع الكرة
ContentAlignment
— محاذاة النص داخل هذا الشكل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
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
getFill()
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
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
getParentPlaceholder()
لعرض عنصر الصفحة الرئيسية للعنصر النائب. يعرض null
إذا لم يكن الشكل عنصرًا نائبًا أو لم يكن له أصل.
استرجاع الكرة
PageElement
: عنصر الصفحة الرئيسي لهذا العنصر النائب للشكل أو null
إذا لم يكن هذا الشكل
عنصرًا نائبًا أو لم يكن له عنصر رئيسي.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPlaceholderIndex()
لعرض فهرس العنصر النائب للشكل. إذا كان هناك مثيلان أو أكثر من أنواع العناصر النائبة
نفسها في الصفحة ذاتها، فسيكون لكل منها قيمة فهرس فريدة خاصة بها. تعرض null
إذا لم يكن الشكل عنصرًا نائبًا.
استرجاع الكرة
Integer
- فهرس العنصر النائب لهذا الشكل أو null
إذا لم يكن الشكل عنصرًا نائبًا.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPlaceholderType()
يتم عرض نوع العنصر النائب للشكل أو PlaceholderType.NONE
إذا لم يكن الشكل عنصرًا نائبًا.
استرجاع الكرة
PlaceholderType
— نوع العنصر النائب لهذا الشكل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
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
getShapeType()
getText()
لعرض المحتوى النصي للشكل.
ينتهي دائمًا النص داخل الشكل بحرف سطر جديد.
استرجاع الكرة
TextRange
- المحتوى النصي لهذا الشكل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
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
preconcatenateTransform(transform)
يربط التحويل المقدم مسبقًا بالتحويل الحالي لعنصر الصفحة.
newTransform = argument * existingTransform
على سبيل المثال، لنقل عناصر صفحة 36 نقطة إلى اليسار:
element.preconcatenateTransform(SlidesApp.newAffineTransformBuilder() .setTranslateX(-36.0) .build());
يمكنك أيضًا استبدال تحويل عنصر الصفحة بـ setTransform(transform)
.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
transform | AffineTransform | التحويل إلى التسلسل المسبق على تحويل عنصر الصفحة هذا. |
استرجاع الكرة
Shape
- عنصر الصفحة هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
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();
replaceWithImage(blobSource)
يستبدل هذا الشكل بصورة مقدّمة من BlobSource
.
يتم استرجاع الصورة من BlobSource
المقدَّمة مرة واحدة عند الإدراج ويتم
تخزين نسخة للعرض داخل العرض التقديمي. يجب أن يكون حجم الصور أقل من 50 ميغابايت، ولا يمكن
أن يتجاوز 25 ميغابكسل، ويجب أن تكون بتنسيق PNG أو JPEG أو GIF.
للحفاظ على نسبة العرض إلى الارتفاع للصورة، يتم تغيير حجم الصورة وتوسيطها بالنسبة إلى حجم الشكل الحالي.
var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0]; // Get the Drive image file with the given ID. var driveImage = DriveApp.getFileById(fileId); shape.replaceWithImage(driveImage);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
blobSource | BlobSource | بيانات الصورة |
استرجاع الكرة
Image
— Image
التي حلت محل الشكل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceWithImage(blobSource, crop)
يستبدل هذا الشكل بصورة مقدّمة من BlobSource
.
عند إدراج الصورة، يتم جلبها من BlobSource
مرة واحدة، كما يتم تخزين نسخة لعرضها في العرض التقديمي. يجب أن يكون حجم الصور أقل من 50 ميغابايت، ولا يمكن أن يتجاوز
25 ميغابكسل، ويجب أن تكون بتنسيق PNG أو JPEG أو GIF.
var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0]; // Get the Drive image file with the given ID. var driveImage = DriveApp.getFileById(fileId); // Replace and crop the replaced image. shape.replaceWithImage(driveImage, true);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
blobSource | BlobSource | بيانات الصورة |
crop | Boolean | إذا تم true ، يتم اقتصاص الصورة لتلائم حجم الشكل الحالي. وبخلاف ذلك، يتم تغيير حجم الصورة وتوسيطها. |
استرجاع الكرة
Image
— Image
التي حلت محل الشكل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceWithImage(imageUrl)
يستبدل هذا الشكل بصورة.
يؤدي إدراج الصورة إلى جلبها من عنوان URL مرة واحدة ويتم تخزين نسخة لعرضها داخل العرض التقديمي. يجب أن يكون حجم الصور أقل من 50 ميغابايت، وألا يتجاوز 25 ميغابكسل، ويجب أن تكون بتنسيق PNG أو JPEG أو GIF.
يجب أن يكون عنوان URL المقدّم متاحًا للجميع، وألا يزيد حجمه عن 2 كيلوبايت. يتم حفظ عنوان URL نفسه
مع الصورة وعرضه عبر Image.getSourceUrl()
.
للحفاظ على نسبة العرض إلى الارتفاع للصورة، يتم تغيير حجم الصورة وتوسيطها بالنسبة إلى حجم الشكل الحالي.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
imageUrl | String | عنوان URL للصورة المطلوب تنزيل الصورة منه |
استرجاع الكرة
Image
— Image
التي حلت محل الشكل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceWithImage(imageUrl, crop)
يستبدل هذا الشكل بصورة.
يؤدي إدراج الصورة إلى جلبها من عنوان URL مرة واحدة ويتم تخزين نسخة لعرضها داخل العرض التقديمي. يجب أن يكون حجم الصور أقل من 50 ميغابايت، وألا يتجاوز 25 ميغابكسل، ويجب أن تكون بتنسيق PNG أو JPEG أو GIF.
يجب ألا يزيد حجم عنوان URL المُقدَّم عن 2 كيلوبايت. يتم حفظ عنوان URL نفسه مع الصورة وعرضه من خلال Image.getSourceUrl()
.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
imageUrl | String | عنوان URL للصورة المطلوب تنزيل الصورة منه |
crop | Boolean | إذا تم true ، يتم اقتصاص الصورة لتلائم حجم الشكل الحالي. وبخلاف ذلك، يتم تغيير حجم الصورة وتوسيطها. |
استرجاع الكرة
Image
— Image
التي حلت محل الشكل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceWithSheetsChart(sourceChart)
يستبدل هذا الشكل بمخطط جداول بيانات Google.
يرتبط المخطط بمخطط جداول بيانات Google المصدر الذي يسمح بتحديثه. يمكن للمتعاونين الآخرين رؤية الرابط إلى جدول البيانات المصدر.
var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; var chart = sheet.getCharts()[0]; // Replace the shape with the Sheets chart. var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0]; shape.replaceWithSheetsChart(chart);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
sourceChart | EmbeddedChart | المخطط في جدول بيانات يحل محل الشكل. |
استرجاع الكرة
SheetsChart
— الرسم البياني الذي حل محل الشكل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceWithSheetsChartAsImage(sourceChart)
يستبدل هذا الشكل بصورة رسم بياني في "جداول بيانات Google".
من أجل الحفاظ على نسبة العرض إلى الارتفاع لمخطط جداول بيانات Google، يتم تغيير حجم صورة المخطط وتوسيطها بالنسبة إلى حجم الشكل الحالي.
صورة المخطط غير مرتبطة بمخطط جداول بيانات Google المصدر.
var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; var chart = sheet.getCharts()[0]; // Replace the shape with the Sheets chart as an image. var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0]; shape.replaceWithSheetsChartAsImage(chart);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
sourceChart | EmbeddedChart | المخطط في جدول بيانات يحل محل الشكل. |
استرجاع الكرة
Image
- صورة الرسم البياني التي حلت محل الشكل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scaleHeight(ratio)
لتحجيم ارتفاع العنصر حسب النسبة المحددة. يكون ارتفاع العنصر هو ارتفاع مربع إحاطته عندما لا يكون للعنصر دوران.
هذه الطريقة غير متوافقة مع جميع عناصر الصفحة. لمعرفة عناصر الصفحة غير المتوافقة مع هذه الطريقة، ارجع إلى قيود الحجم وتحديد الموضع.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
ratio | Number | النسبة المستخدَمة لقياس ارتفاع عنصر الصفحة هذا. |
استرجاع الكرة
Shape
- عنصر الصفحة هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scaleWidth(ratio)
لتحجيم عرض العنصر حسب النسبة المحددة. يكون عرض العنصر هو عرض مربع إحاطته عندما لا يكون للعنصر دوران.
هذه الطريقة غير متوافقة مع جميع عناصر الصفحة. لمعرفة عناصر الصفحة غير المتوافقة مع هذه الطريقة، ارجع إلى قيود الحجم وتحديد الموضع.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
ratio | Number | النسبة المستخدَمة لتغيير عرض عنصر الصفحة هذا. |
استرجاع الكرة
Shape
- عنصر الصفحة هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
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); }
المَعلمات
الاسم | Type | الوصف |
---|---|---|
replace | Boolean | إذا تم اختيار true ، سيحلّ الاختيار محل أي اختيار سابق، وإلّا ستتم إضافة الاختيار إلى أي اختيار سابق. |
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
sendBackward()
لإعادة عنصر الصفحة إلى الخلف على الصفحة بواسطة عنصر واحد.
يجب ألا يكون عنصر الصفحة في مجموعة.
استرجاع الكرة
Shape
- عنصر الصفحة هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
sendToBack()
لإرسال عنصر الصفحة إلى الجزء الخلفي من الصفحة.
يجب ألا يكون عنصر الصفحة في مجموعة.
استرجاع الكرة
Shape
- عنصر الصفحة هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setContentAlignment(contentAlignment)
ضبط ContentAlignment
للنص في الشكل.
تؤدي هذه الطريقة تلقائيًا إلى إيقاف خصائص الاحتواء التلقائي للنص في الأشكال التي تم تعديلها.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
contentAlignment | ContentAlignment | المحاذاة المراد ضبطها. |
استرجاع الكرة
Shape
- هذا الشكل للسلاسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
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());
المَعلمات
الاسم | Type | الوصف |
---|---|---|
description | String | السلسلة المطلوب ضبط وصف النص البديل عليها. |
استرجاع الكرة
Shape
— عنصر الصفحة هذا
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setHeight(height)
لتعيين ارتفاع العنصر بالنقاط، وهو ارتفاع مربع إحاطة العنصر عندما لا يكون له دوران.
هذه الطريقة غير متوافقة مع جميع عناصر الصفحة. لمعرفة عناصر الصفحة غير المتوافقة مع هذه الطريقة، ارجع إلى قيود الحجم وتحديد الموضع.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
height | Number | الارتفاع الجديد لعنصر الصفحة هذا المطلوب ضبطه، بالنقاط. |
استرجاع الكرة
Shape
- عنصر الصفحة هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLeft(left)
لتحديد الموضع الأفقي للعنصر بالنقاط، ويتم قياسه من الزاوية العلوية اليسرى للصفحة عندما لا يكون للعنصر أي دوران.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
left | Number | الموضع الأفقي الجديد المطلوب تعيينه بالنقاط. |
استرجاع الكرة
Shape
- عنصر الصفحة هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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");
المَعلمات
الاسم | Type | الوصف |
---|---|---|
url | String | سلسلة عنوان URL. |
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setRotation(angle)
لضبط زاوية تدوير العنصر في اتجاه عقارب الساعة حول مركزه بالدرجات.
هذه الطريقة غير متوافقة مع جميع عناصر الصفحة. لمعرفة عناصر الصفحة غير المتوافقة مع هذه الطريقة، ارجع إلى قيود الحجم وتحديد الموضع.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
angle | Number | زاوية الدوران الجديدة في اتجاه عقارب الساعة المطلوب ضبطها، بالدرجات. |
استرجاع الكرة
Shape
- عنصر الصفحة هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
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());
المَعلمات
الاسم | Type | الوصف |
---|---|---|
title | String | السلسلة المطلوب تعيين عنوان النص البديل عليها. |
استرجاع الكرة
Shape
— عنصر الصفحة هذا
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTop(top)
لضبط الموضع الرأسي للعنصر بالنقاط، يتم قياسه من الزاوية العلوية اليسرى للصفحة عندما لا يكون للعنصر دوران.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
top | Number | الموضع الرأسي الجديد المطلوب تعيينه بالنقاط. |
استرجاع الكرة
Shape
- عنصر الصفحة هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTransform(transform)
لضبط تحويل عنصر الصفحة مع التحويل المقدم.
يؤدي تحديث تحويل المجموعة إلى تغيير التحويل المطلق لعناصر الصفحة في تلك المجموعة، مما قد يغير مظهرها المرئي.
ويؤدي تعديل عملية تحويل عنصر صفحة ضمن مجموعة فقط إلى تغيير عملية تحويل عنصر الصفحة هذا، ولا يؤثر في عمليات التحويل للمجموعة أو عناصر الصفحة الأخرى في المجموعة.
للحصول على تفاصيل عن كيفية تأثير عمليات التحويل في المظهر المرئي لعناصر الصفحة، يُرجى الاطّلاع على getTransform()
.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
transform | AffineTransform | التحويل الذي يتم تعيينه لعنصر الصفحة هذا. |
استرجاع الكرة
Shape
: هذا العنصر للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setWidth(width)
لتعيين عرض العنصر بالنقاط، وهو عرض مربع إحاطة العنصر عندما لا يكون للعنصر دوران.
هذه الطريقة غير متوافقة مع جميع عناصر الصفحة. لمعرفة عناصر الصفحة غير المتوافقة مع هذه الطريقة، ارجع إلى قيود الحجم وتحديد الموضع.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
width | Number | العرض الجديد لعنصر الصفحة هذا المطلوب تعيينه، بالنقاط. |
استرجاع الكرة
Shape
- عنصر الصفحة هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations