رمز PageElement
يمثّل صورة
الطُرق
الطريقة | نوع الإرجاع | وصف قصير |
---|---|---|
alignOnPage(alignmentPosition) | Image | لمحاذاة العنصر مع موضع المحاذاة المحدد على الصفحة. |
bringForward() | Image | لإحضار عنصر الصفحة إلى الأمام في الصفحة بواسطة عنصر واحد. |
bringToFront() | Image | لنقل عنصر الصفحة إلى مقدّمة الصفحة. |
duplicate() | PageElement | يؤدي هذا الإجراء إلى تكرار عنصر الصفحة. |
getAs(contentType) | Blob | عرض البيانات داخل هذا الكائن على شكل كائن ثنائي كبير تم تحويله إلى نوع المحتوى المحدّد. |
getBlob() | Blob | عرض البيانات داخل هذه الصورة على شكل كائن ثنائي كبير. |
getBorder() | Border | تعرض Border للصورة. |
getConnectionSites() | ConnectionSite[] | يتم عرض قائمة ConnectionSite s في عنصر الصفحة أو قائمة فارغة إذا لم يتضمّن عنصر الصفحة أي مواقع اتصال. |
getContentUrl() | String | الحصول على عنوان URL للصورة |
getDescription() | String | تعرض وصف النص البديل لعنصر الصفحة. |
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 | عرض زاوية تدوير العنصر في اتجاه عقارب الساعة حول مركزه بالدرجات، حيث إن صفر درجة تعني عدم وجود دوران. |
getSourceUrl() | String | تتيح لك هذه السياسة الحصول على عنوان URL لمصدر الصورة في حال توفّره. |
getTitle() | String | تعرض عنوان النص البديل لعنصر الصفحة. |
getTop() | Number | يحصل على الموضع الرأسي للعنصر بالنقاط، ويتم قياسه من الزاوية العلوية اليسرى من الصفحة عندما لا يحتوي العنصر على تدوير. |
getTransform() | AffineTransform | لعرض تحويل عنصر الصفحة. |
getWidth() | Number | يتم عرض عرض العنصر بالنقاط، وهو عرض مربع إحاطة العنصر عندما لا يكون له تدوير. |
preconcatenateTransform(transform) | Image | إنشاء تسلسل مسبق لعملية التحويل المتوفرة لعملية التحويل الحالية لعنصر الصفحة. |
remove() | void | لإزالة عنصر الصفحة. |
removeLink() | void | ستتم إزالة Link . |
replace(blobSource) | Image | يستبدل هذه الصورة بصورة موضّحة من خلال عنصر BlobSource . |
replace(blobSource, crop) | Image | لاستبدال هذه الصورة بصورة يصفها كائن Image ، يمكنك اقتصاص الصورة اختياريًا لتتلاءم. |
replace(imageUrl) | Image | يستبدل هذه الصورة بصورة أخرى تم تنزيلها من عنوان URL المقدّم. |
replace(imageUrl, crop) | Image | لاستبدال هذه الصورة بصورة أخرى تم تنزيلها من عنوان URL المقدَّم، ويمكنك اقتصاص الصورة بشكل اختياري لتلائم الصورة. |
scaleHeight(ratio) | Image | تعمل على قياس ارتفاع العنصر بنسبة محددة. |
scaleWidth(ratio) | Image | تعمل هذه السمة على زيادة عرض العنصر وفقًا للنسبة المحددة. |
select() | void | يؤدي هذا الإجراء إلى اختيار PageElement فقط في العرض التقديمي النشط وإزالة أي اختيار سابق. |
select(replace) | void | لاختيار "PageElement " في العرض التقديمي النشط |
sendBackward() | Image | لإعادة عنصر الصفحة إلى الخلف في الصفحة بواسطة عنصر واحد. |
sendToBack() | Image | لإرسال عنصر الصفحة إلى الجزء الخلفي من الصفحة |
setDescription(description) | Image | لضبط وصف النص البديل لعنصر الصفحة. |
setHeight(height) | Image | لتعيين ارتفاع العنصر بالنقاط، وهو ارتفاع مربع إحاطة العنصر عندما لا يكون له دوران. |
setLeft(left) | Image | تضبط الموضع الأفقي للعنصر بالنقاط، ويتم قياسها من الزاوية العلوية اليسرى للصفحة عند عدم تدوير العنصر. |
setLinkSlide(slideIndex) | Link | لضبط Link على Slide المحدّد باستخدام فهرس الشريحة الصفرية |
setLinkSlide(slide) | Link | لضبط Link على Slide المحدّد، يتم ضبط الرابط من خلال رقم تعريف الشريحة المحدّد. |
setLinkSlide(slidePosition) | Link | لضبط Link على Slide المحدّد باستخدام الموضع النسبي للشريحة |
setLinkUrl(url) | Link | تضبط Link على سلسلة عنوان URL غير الفارغة المحدّدة. |
setRotation(angle) | Image | تضبط زاوية تدوير العنصر في اتجاه عقارب الساعة حول مركزه بالدرجات. |
setTitle(title) | Image | لتعيين عنوان النص البديل لعنصر الصفحة. |
setTop(top) | Image | لضبط الموضع الرأسي للعنصر بالنقاط، ويتم قياسه من الزاوية العلوية اليسرى من الصفحة عندما لا يحتوي العنصر على دوران. |
setTransform(transform) | Image | لضبط تحويل عنصر الصفحة باستخدام التحويل المتوفر. |
setWidth(width) | Image | لتعيين عرض العنصر بالنقاط، وهو عرض مربع إحاطة العنصر عندما لا يكون له دوران. |
الوثائق التفصيلية
alignOnPage(alignmentPosition)
لمحاذاة العنصر مع موضع المحاذاة المحدد على الصفحة.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
alignmentPosition | AlignmentPosition | الموضع الذي يجب محاذاة عنصر الصفحة هذا معه على الصفحة. |
الإرجاع
Image
— عنصر الصفحة هذا، للتسلسل.
bringForward()
لإحضار عنصر الصفحة إلى الأمام في الصفحة بواسطة عنصر واحد.
يجب ألا يكون عنصر الصفحة في مجموعة.
الإرجاع
Image
— عنصر الصفحة هذا، للتسلسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
bringToFront()
لنقل عنصر الصفحة إلى مقدّمة الصفحة.
يجب ألا يكون عنصر الصفحة في مجموعة.
الإرجاع
Image
— عنصر الصفحة هذا، للتسلسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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
getAs(contentType)
عرض البيانات داخل هذا الكائن على شكل كائن ثنائي كبير تم تحويله إلى نوع المحتوى المحدّد. تضيف هذه الطريقة الامتداد المناسب لاسم الملف - على سبيل المثال، "myfile.pdf". ومع ذلك، يفترض أن جزء اسم الملف الذي يلي النقطة الأخيرة (إن وجدت) هو امتداد موجود يجب استبداله. وبالتالي، تصبح "ShoppingList.12.25.2014" "ShoppingList.12.25.pdf".
لعرض الحصص اليومية للإحالات الناجحة، راجِع حصص خدمات Google. قد تخضع نطاقات Google Workspace التي تم إنشاؤها حديثًا لأسعار مخفّضة بشكل مؤقت.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
contentType | String | نوع MIME المطلوب التحويل إليه. بالنسبة إلى معظم الكائنات الثنائية الكبيرة، يكون 'application/pdf' هو
الخيار الوحيد الصالح. بالنسبة إلى الصور بتنسيق BMP أو GIF أو JPEG أو PNG، يكون أي من 'image/bmp' أو 'image/gif' أو 'image/jpeg' أو 'image/png' صالحًا أيضًا. |
الإرجاع
Blob
— البيانات ككائنات ثنائية كبيرة (blob).
getBlob()
عرض البيانات داخل هذه الصورة على شكل كائن ثنائي كبير.
الإرجاع
Blob
— بيانات الصورة كثنائي كبير (blob).
getBorder()
getConnectionSites()
يتم عرض قائمة ConnectionSite
s في عنصر الصفحة أو قائمة فارغة إذا لم يتضمّن عنصر الصفحة أي مواقع اتصال.
الإرجاع
ConnectionSite[]
: قائمة المواقع الإلكترونية للاتصال، وقد تكون فارغة إذا لم يكن لهذا العنصر مواقع اتصال
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getContentUrl()
الحصول على عنوان URL للصورة
تم وضع علامة على عنوان URL هذا باستخدام حساب مقدّم الطلب، ما يتيح لأي مستخدم لديه عنوان URL الوصول بفعالية إلى الصورة بصفته مقدِّم الطلب الأصلي. قد تُفقد إمكانية الوصول إلى الصورة في حال تغيير إعدادات مشاركة العرض التقديمي. تنتهي صلاحية عنوان URL المعروض بعد فترة زمنية قصيرة.
الإرجاع
String
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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
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
getSourceUrl()
تتيح لك هذه السياسة الحصول على عنوان URL لمصدر الصورة في حال توفّره.
عند إدراج صورة باستخدام عنوان URL، يتم عرض عنوان URL المقدَّم أثناء إدراج الصورة.
الإرجاع
String
: عنوان URL الخاص بالصورة أو null
إذا لم يكن لها عنوان URL مصدر
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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)
.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
transform | AffineTransform | التحويل لإجراء تسلسل مسبق لتحويل عنصر هذه الصفحة. |
الإرجاع
Image
— عنصر الصفحة هذا، للتسلسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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();
replace(blobSource)
يستبدل هذه الصورة بصورة موضّحة من خلال عنصر BlobSource
.
يؤدي إدراج الصورة إلى استرجاعها من
BlobSource
مرة واحدة ويتم تخزين نسخة لعرضها داخل العرض التقديمي.
يجب أن يكون حجم الصور أقل من 50 ميغابايت، ولا يمكن أن يتجاوز 25 ميغابكسل، ويجب أن تكون بتنسيق PNG أو JPEG أو GIF.
للحفاظ على نسبة العرض إلى الارتفاع للصورة، يتم تحجيم الصورة وتوسيطها فيما يتعلق بحجم الصورة الموجودة.
var image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0]; // Get the Drive image file with the given ID. var driveImage = DriveApp.getFileById(fileId); image.replace(driveImage);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
blobSource | BlobSource | بيانات الصورة |
الإرجاع
Image
— سيتم تطبيق "Image
" بعد الاستبدال.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace(blobSource, crop)
لاستبدال هذه الصورة بصورة يصفها كائن Image
، يمكنك اقتصاص الصورة اختياريًا لتتلاءم.
يؤدي إدراج الصورة إلى استرجاعها من
BlobSource
مرة واحدة ويتم تخزين نسخة لعرضها داخل العرض التقديمي.
يجب أن يكون حجم الصور أقل من 50 ميغابايت، ولا يمكن أن يتجاوز 25 ميغابكسل، ويجب أن تكون بتنسيق PNG أو JPEG أو GIF.
var image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0]; // Get the Drive image file with the given ID. var driveImage = DriveApp.getFileById(fileId); // Replace and crop the drive image. image.replace(driveImage, true);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
blobSource | BlobSource | بيانات الصورة |
crop | Boolean | إذا كانت true ، سيتم اقتصاص الصورة لتتناسب مع حجم الصورة الحالية. وبخلاف ذلك، سيتم تحجيم
الصورة وتوسيطها. |
الإرجاع
Image
— سيتم تطبيق "Image
" بعد الاستبدال.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace(imageUrl)
يستبدل هذه الصورة بصورة أخرى تم تنزيلها من عنوان URL المقدّم.
يؤدي إدراج الصورة إلى استرجاعها من عنوان URL مرة واحدة وتخزين نسخة منها لعرضها داخل العرض التقديمي. يجب ألا يزيد حجم الصور عن 50 ميغابايت، وألا يزيد حجمها عن 25 ميغابكسل، ويجب أن تكون بتنسيق PNG أو JPEG أو GIF.
يجب أن يكون عنوان URL المقدَّم متاحًا للجميع، ويجب ألا يزيد حجمه عن 2 كيلوبايت. ويتم حفظ عنوان URL نفسه
مع الصورة وعرضه من خلال getSourceUrl()
.
للحفاظ على نسبة العرض إلى الارتفاع للصورة، يتم تحجيم الصورة وتوسيطها فيما يتعلق بحجم الصورة الموجودة.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
imageUrl | String | عنوان URL المطلوب تنزيل الصورة منه |
الإرجاع
Image
— سيتم تطبيق "Image
" بعد الاستبدال.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace(imageUrl, crop)
لاستبدال هذه الصورة بصورة أخرى تم تنزيلها من عنوان URL المقدَّم، ويمكنك اقتصاص الصورة بشكل اختياري لتلائم الصورة.
يؤدي إدراج الصورة إلى استرجاعها من عنوان URL مرة واحدة وتخزين نسخة منها لعرضها داخل العرض التقديمي. يجب ألا يزيد حجم الصور عن 50 ميغابايت، وألا يزيد حجمها عن 25 ميغابكسل، ويجب أن تكون بتنسيق PNG أو JPEG أو GIF.
يجب ألا يزيد حجم عنوان URL المقدَّم عن 2 كيلوبايت.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
imageUrl | String | عنوان URL المطلوب تنزيل الصورة منه |
crop | Boolean | إذا كانت true ، سيتم اقتصاص الصورة لتتناسب مع حجم الصورة الحالية. وبخلاف ذلك، سيتم تحجيم
الصورة وتوسيطها. |
الإرجاع
Image
— سيتم تطبيق "Image
" بعد الاستبدال.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scaleHeight(ratio)
تعمل على قياس ارتفاع العنصر بنسبة محددة. ارتفاع العنصر هو ارتفاع المربع المحيط به عندما لا يحتوي العنصر على تدوير.
هذه الطريقة غير متوافقة مع بعض عناصر الصفحة. لمعرفة عناصر الصفحة غير المتوافقة مع هذه الطريقة، راجِع قيود الحجم وتحديد الموضع.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
ratio | Number | يشير ذلك المصطلح إلى النسبة المستخدمة في قياس ارتفاع عنصر الصفحة هذا. |
الإرجاع
Image
— عنصر الصفحة هذا، للتسلسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scaleWidth(ratio)
تعمل هذه السمة على زيادة عرض العنصر وفقًا للنسبة المحددة. يكون عرض العنصر هو عرض المربع المحيط به عندما لا يحتوي العنصر على تدوير.
هذه الطريقة غير متوافقة مع بعض عناصر الصفحة. لمعرفة عناصر الصفحة غير المتوافقة مع هذه الطريقة، راجِع قيود الحجم وتحديد الموضع.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
ratio | Number | يشير ذلك المصطلح إلى النسبة المستخدَمة لقياس عرض عنصر الصفحة هذا. |
الإرجاع
Image
— عنصر الصفحة هذا، للتسلسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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()
لإعادة عنصر الصفحة إلى الخلف في الصفحة بواسطة عنصر واحد.
يجب ألا يكون عنصر الصفحة في مجموعة.
الإرجاع
Image
— عنصر الصفحة هذا، للتسلسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
sendToBack()
لإرسال عنصر الصفحة إلى الجزء الخلفي من الصفحة
يجب ألا يكون عنصر الصفحة في مجموعة.
الإرجاع
Image
— عنصر الصفحة هذا، للتسلسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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 | السلسلة المطلوب تعيين وصف النص البديل إليها. |
الإرجاع
Image
— عنصر الصفحة هذا
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setHeight(height)
لتعيين ارتفاع العنصر بالنقاط، وهو ارتفاع مربع إحاطة العنصر عندما لا يكون له دوران.
هذه الطريقة غير متوافقة مع بعض عناصر الصفحة. لمعرفة عناصر الصفحة غير المتوافقة مع هذه الطريقة، راجِع قيود الحجم وتحديد الموضع.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
height | Number | تمثّل هذه السمة الارتفاع الجديد لعنصر الصفحة المطلوب تحديده، بالنقاط. |
الإرجاع
Image
— عنصر الصفحة هذا، للتسلسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLeft(left)
تضبط الموضع الأفقي للعنصر بالنقاط، ويتم قياسها من الزاوية العلوية اليسرى للصفحة عند عدم تدوير العنصر.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
left | Number | الموضع الأفقي الجديد الذي يجب تحديده بالنقاط. |
الإرجاع
Image
— عنصر الصفحة هذا، للتسلسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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 | زاوية التدوير الجديدة في اتجاه عقارب الساعة المطلوب ضبطها، بالدرجات. |
الإرجاع
Image
— عنصر الصفحة هذا، للتسلسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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 | السلسلة المطلوب تعيين عنوان النص البديل إليها. |
الإرجاع
Image
— عنصر الصفحة هذا
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTop(top)
لضبط الموضع الرأسي للعنصر بالنقاط، ويتم قياسه من الزاوية العلوية اليسرى من الصفحة عندما لا يحتوي العنصر على دوران.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
top | Number | الموضع العمودي الجديد الذي يجب تحديده بالنقاط |
الإرجاع
Image
— عنصر الصفحة هذا، للتسلسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTransform(transform)
لضبط تحويل عنصر الصفحة باستخدام التحويل المتوفر.
يؤدي تحديث تحويل مجموعة إلى تغيير التحويل المطلق لعناصر الصفحة في تلك المجموعة، مما قد يؤدي إلى تغيير مظهرها المرئي.
وعند تعديل تغيير عنصر صفحة في مجموعة، يغيِّر فقط تحويل عنصر الصفحة، ولا يؤثر في عمليات تحويل المجموعة أو عناصر الصفحة الأخرى ضمن المجموعة.
للحصول على تفاصيل حول كيفية تأثير الإحالات الناجحة في المظهر المرئي لعناصر الصفحة، يُرجى الاطّلاع على getTransform()
.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
transform | AffineTransform | التحويل الذي يتم تعيينه لعنصر الصفحة هذا. |
الإرجاع
Image
— هذا العنصر، للتسلسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setWidth(width)
لتعيين عرض العنصر بالنقاط، وهو عرض مربع إحاطة العنصر عندما لا يكون له دوران.
هذه الطريقة غير متوافقة مع بعض عناصر الصفحة. لمعرفة عناصر الصفحة غير المتوافقة مع هذه الطريقة، راجِع قيود الحجم وتحديد الموضع.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
width | Number | العرض الجديد لعنصر الصفحة هذا المطلوب تعيينه، بالنقاط. |
الإرجاع
Image
— عنصر الصفحة هذا، للتسلسل.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations