Class Layout

التصميم

تنسيق في عرض تقديمي

يعمل كل تنسيق كنموذج للشرائح التي ترث منه، ما يحدّد كيفية ترتيب المحتوى على هذه الشرائح وتصميمه.

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
getBackground()PageBackgroundالحصول على خلفية الصفحة
getColorScheme()ColorSchemeالحصول على ColorScheme المرتبط بالصفحة
getGroups()Group[]عرض قائمة Group عنصر في الصفحة
getImages()Image[]عرض قائمة Image عنصر في الصفحة
getLayoutName()Stringتحصل على اسم التنسيق.
getLines()Line[]عرض قائمة Line عنصر في الصفحة
getMaster()Masterتحصل على التصميم الرئيسي الذي يستند إليه التنسيق.
getObjectId()Stringتحصل على المعرّف الفريد للصفحة.
getPageElementById(id)PageElementتعرِض هذه السمة العنصر PageElement في الصفحة التي تحمل المعرّف المحدّد، أو null إذا لم يكن هناك أي عنصر.
getPageElements()PageElement[]عرض قائمة PageElement عناصر معروضة على الصفحة
getPageType()PageTypeالحصول على نوع الصفحة
getPlaceholder(placeholderType)PageElementعرض عنصر العنصر النائب PageElement لعنصر PlaceholderType أو null محدّد إذا لم يكن هناك عنصر نائب مطابق
getPlaceholder(placeholderType, placeholderIndex)PageElementعرض عنصر العنصر النائب PageElement لـ PlaceholderType و فهرس العنصر النائب المحدّد، أو null إذا لم يكن العنصر النائب متوفّرًا
getPlaceholders()PageElement[]عرض قائمة عناصر العنصر النائب PageElement في الصفحة
getShapes()Shape[]عرض قائمة Shape عنصر في الصفحة
getSheetsCharts()SheetsChart[]عرض قائمة SheetsChart عنصر في الصفحة
getTables()Table[]عرض قائمة Table عنصر في الصفحة
getVideos()Video[]عرض قائمة Video عنصر في الصفحة
getWordArts()WordArt[]عرض قائمة WordArt عنصر في الصفحة
group(pageElements)Groupتُجمِّع جميع عناصر الصفحة المحدّدة.
insertGroup(group)Groupتُدرج هذه السمة نسخة من Group المقدَّمة في الصفحة.
insertImage(blobSource)Imageتُدرج هذه العلامة صورة في أعلى يمين الصفحة بحجم تلقائي من كتلة الصورة المحدّدة.
insertImage(blobSource, left, top, width, height)Imageتُدرج هذه العلامة صورة في الصفحة بالموضع والحجم المقدَّمين من قطعة البيانات المحدّدة للصورة.
insertImage(image)Imageتُدرج هذه السمة نسخة من Image المقدَّمة في الصفحة.
insertImage(imageUrl)Imageتُدرِج هذه العلامة صورة في أعلى يمين الصفحة بحجم تلقائي من عنوان URL المقدَّم.
insertImage(imageUrl, left, top, width, height)Imageتُدرِج هذه العلامة صورة في الصفحة بالموضع والحجم المقدَّمين من عنوان URL المقدَّم.
insertLine(line)Lineتُدرج هذه السمة نسخة من Line المقدَّمة في الصفحة.
insertLine(lineCategory, startConnectionSite, endConnectionSite)Lineتُدرج هذه العلامة خطًا في الصفحة يربط بين connection sites.
insertLine(lineCategory, startLeft, startTop, endLeft, endTop)Lineلإدراج سطر في الصفحة
insertPageElement(pageElement)PageElementتُدرج هذه السمة نسخة من PageElement المقدَّمة في الصفحة.
insertShape(shape)Shapeتُدرج هذه السمة نسخة من Shape المقدَّمة في الصفحة.
insertShape(shapeType)Shapeلإدراج شكل في الصفحة
insertShape(shapeType, left, top, width, height)Shapeلإدراج شكل في الصفحة
insertSheetsChart(sourceChart)SheetsChartتُدرج هذه الدالة رسمًا بيانيًا من "جداول بيانات Google" في الصفحة.
insertSheetsChart(sourceChart, left, top, width, height)SheetsChartتُدرج هذه الدالة رسمًا بيانيًا من "جداول بيانات Google" في الصفحة بالموضع والحجم المقدَّمين.
insertSheetsChart(sheetsChart)SheetsChartتُدرج هذه السمة نسخة من SheetsChart المقدَّمة في الصفحة.
insertSheetsChartAsImage(sourceChart)Imageتُستخدَم هذه السمة لإدراج رسم بياني من "جداول بيانات Google" كعنصر Image في الصفحة.
insertSheetsChartAsImage(sourceChart, left, top, width, height)Imageتُدرج هذه الدالة رسمًا بيانيًا من "جداول بيانات Google" كعنصر Image في الصفحة بالوضع والحجم المقدَّمين.
insertTable(numRows, numColumns)Tableتُستخدَم لإدراج جدول في الصفحة.
insertTable(numRows, numColumns, left, top, width, height)Tableتُدرج هذه الدالة جدولاً في الصفحة بالموضع والحجم المقدَّمين.
insertTable(table)Tableتُدرج هذه السمة نسخة من Table المقدَّمة في الصفحة.
insertTextBox(text)Shapeتُدرج هذه الدالة مربّع نص Shape يحتوي على السلسلة المقدَّمة في الصفحة.
insertTextBox(text, left, top, width, height)Shapeتُدرج هذه الدالة مربّع نص Shape يحتوي على السلسلة المقدَّمة في الصفحة.
insertVideo(videoUrl)Videoتُدرج هذه الأداة فيديو بحجم تلقائي في أعلى يمين الصفحة.
insertVideo(videoUrl, left, top, width, height)Videoتُدرج هذه الدالة فيديو في الصفحة بالموضع والحجم المقدَّمين.
insertVideo(video)Videoتُدرج هذه السمة نسخة من Video المقدَّمة في الصفحة.
insertWordArt(wordArt)WordArtتُدرج هذه السمة نسخة من WordArt المقدَّمة في الصفحة.
remove()voidإزالة الصفحة
replaceAllText(findText, replaceText)Integerاستبدال جميع تكرارات النص الذي يتطابق مع النص المراد البحث عنه بالنص البديل
replaceAllText(findText, replaceText, matchCase)Integerاستبدال جميع تكرارات النص الذي يتطابق مع النص المراد البحث عنه بالنص البديل
selectAsCurrentPage()voidلاختيار Page في العرض النشط كـ current page selection وإزالة أي اختيار سابق

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

getBackground()

الحصول على خلفية الصفحة

الإرجاع

PageBackground: خلفية الصفحة

التفويض

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

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

getColorScheme()

الحصول على ColorScheme المرتبط بالصفحة

الإرجاع

ColorScheme: نظام ألوان الصفحة

التفويض

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

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

getGroups()

عرض قائمة Group عنصر في الصفحة

الإرجاع

Group[]

التفويض

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

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

getImages()

عرض قائمة Image عنصر في الصفحة

الإرجاع

Image[]

التفويض

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

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

getLayoutName()

تحصل على اسم التنسيق.

الإرجاع

String

التفويض

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

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

getLines()

عرض قائمة Line عنصر في الصفحة

الإرجاع

Line[]

التفويض

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

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

getMaster()

تحصل على التصميم الرئيسي الذي يستند إليه التنسيق.

الإرجاع

Master

التفويض

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

  • 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

getPageElementById(id)

تعرِض هذه السمة العنصر PageElement في الصفحة التي تحمل المعرّف المحدّد، أو null إذا لم يكن هناك أي عنصر.

المعلمات

الاسمالنوعالوصف
idStringمعرّف عنصر الصفحة الذي يتم استرجاعه.

الإرجاع

PageElement: عنصر الصفحة الذي يحمل المعرّف المحدّد

التفويض

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

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

getPageElements()

عرض قائمة PageElement عناصر معروضة على الصفحة

الإرجاع

PageElement[]

التفويض

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

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

getPageType()

الحصول على نوع الصفحة

الإرجاع

PageType: نوع الصفحة

التفويض

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

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

getPlaceholder(placeholderType)

عرض عنصر العنصر النائب PageElement لعنصر PlaceholderType أو null محدّد إذا لم يكن هناك عنصر نائب مطابق

إذا كانت هناك عناصر نائبة متعددة من النوع نفسه، يتم عرض العنصر الذي يحتوي على أدنى قيمة لفهرس العنصر النائب. إذا كانت هناك عناصر نائبة متعددة متطابقة لها الفهرس نفسه، يتم عرض العنصر النائب الأول من مجموعة عناصر الصفحة. 

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const placeholder = slide.getPlaceholder(
    SlidesApp.PlaceholderType.CENTERED_TITLE,
);

المعلمات

الاسمالنوعالوصف
placeholderTypePlaceholderType

الإرجاع

PageElement

التفويض

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

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

getPlaceholder(placeholderType, placeholderIndex)

عرض عنصر العنصر النائب PageElement لـ PlaceholderType و فهرس العنصر النائب المحدّد، أو null إذا لم يكن العنصر النائب متوفّرًا

إذا كانت هناك عناصر نائبة متعددة من النوع والفهرس نفسهما، يتم عرض العنصر النائب الأول من مجموعة عناصر الصفحة. 

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const placeholder = slide.getPlaceholder(
    SlidesApp.PlaceholderType.CENTERED_TITLE,
    0,
);

المعلمات

الاسمالنوعالوصف
placeholderTypePlaceholderType
placeholderIndexInteger

الإرجاع

PageElement

التفويض

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

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

getPlaceholders()

عرض قائمة عناصر العنصر النائب PageElement في الصفحة 

const master = SlidesApp.getActivePresentation().getMasters()[0];
Logger.log(
    `Number of placeholders in the master: ${master.getPlaceholders().length}`,
);

الإرجاع

PageElement[]

التفويض

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

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

getShapes()

عرض قائمة Shape عنصر في الصفحة

الإرجاع

Shape[]

التفويض

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

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

getSheetsCharts()

عرض قائمة SheetsChart عنصر في الصفحة

الإرجاع

SheetsChart[]

التفويض

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

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

getTables()

عرض قائمة Table عنصر في الصفحة

الإرجاع

Table[]

التفويض

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

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

getVideos()

عرض قائمة Video عنصر في الصفحة

الإرجاع

Video[]

التفويض

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

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

getWordArts()

عرض قائمة WordArt عنصر في الصفحة

الإرجاع

WordArt[]

التفويض

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

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

group(pageElements)

تُجمِّع جميع عناصر الصفحة المحدّدة.

يجب أن يكون هناك عنصران على الأقل من عناصر الصفحة في الصفحة نفسها غير مُدرَجين في مجموعة أخرى. لا يمكن تجميع بعض عناصر الصفحة، مثل Videos وTables وplaceholder Shapes.

المعلمات

الاسمالنوعالوصف
pageElementsPageElement[]العناصر المطلوب تجميعها معًا

الإرجاع

Group: المجموعة الجديدة

التفويض

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

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

insertGroup(group)

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

يتم تحديد موضع العنصر المُدرَج في هذه الصفحة من موضع العنصر المصدر في صفحته المعنيّة.

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

إذا كان العنصر المقدَّم عنصر نائب يتم نسخه من عرض تقديمي مختلف، تتم نسخ الخصائص التي يتم اكتسابها من صفحات التنسيق أو الصفحات الرئيسية على العنصر من عرض التقديم المصدر. 

// Copy a group between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const group = otherPresentationSlide.getGroups()[0];
currentPresentationSlide.insertGroup(
    group);  // Also available for Layout, Master, and Page.

المعلمات

الاسمالنوعالوصف
groupGroupالمجموعة التي سيتمّ نسخها وإدراجها.

الإرجاع

Group: المجموعة المُدرَجة

التفويض

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

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

insertImage(blobSource)

تُدرج هذه العلامة صورة في أعلى يمين الصفحة بحجم تلقائي من كتلة الصورة المحدّدة.

عند إدراج الصورة، يتم جلبها من BlobSource مرة واحدة ويتم تخزين نسخة منها لعرضها داخل العرض التقديمي. يجب أن يكون حجم الصور أقل من 50 ميغابايت، وألّا يزيد عن 25 ميغابيكسل، ويجب أن تكون بتنسيق PNG أو JPEG أو GIF. 

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
const image = DriveApp.getFileById('123abc');
slide.insertImage(image);

المعلمات

الاسمالنوعالوصف
blobSourceBlobSourceبيانات الصورة

الإرجاع

Image: الصورة المُدرَجة

التفويض

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

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

insertImage(blobSource, left, top, width, height)

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

يتم جلب الصورة من BlobSource المقدَّمة مرة واحدة في وقت الإدراج ويتم تخزين نسخة لعرضها داخل العرض التقديمي. يجب أن يكون حجم الصور أقل من 50 ميغابايت، وألّا تتعدى دقتها 25 ميغابكسل، ويجب أن تكون بتنسيق PNG أو JPEG أو GIF.

للحفاظ على نسبة العرض إلى الارتفاع للصورة، يتم تعديل حجمها ووضعها في المنتصف بالاستناد إلى الحجم المقدَّم. 

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// Get the Drive image file with the given ID.
const image = DriveApp.getFileById('123abc');
const position = {
  left: 0,
  top: 0
};
const size = {
  width: 300,
  height: 100
};
slide.insertImage(image, position.left, position.top, size.width, size.height);

المعلمات

الاسمالنوعالوصف
blobSourceBlobSourceبيانات الصورة
leftNumberالموضع الأفقي للصورة بالنقاط، ويتم قياسه من أعلى يمين الصفحة.
topNumberالموضع العمودي للصورة بالنقاط، ويتم قياسه من أعلى يمين الصفحة.
widthNumberعرض الصورة بالنقاط
heightNumberارتفاع الصورة بالنقاط.

الإرجاع

Image: الصورة المُدرَجة

التفويض

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

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

insertImage(image)

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

يتم تحديد موضع الصور المُدرَجة في هذه الصفحة من موضع الصورة المصدر في صفحتها المعنيّة.

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

إذا كانت الصورة المقدَّمة عنصر نائب يتم نسخه من عرض تقديمي مختلف، تتم نسخ السمات التي يتم اكتسابها من صفحات التنسيق أو الصفحات الرئيسية على الصورة من عرض التقديم المصدر. إذا كانت صورة العنصر النائب المنسوخة فارغة، لن يتم إدراج أي محتوى في عرض الوجهة. 

// Copy an image between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const image = otherPresentationSlide.getImages[0];
currentPresentationSlide.insertImage(image);

المعلمات

الاسمالنوعالوصف
imageImageالصورة التي سيتم نسخها وإدراجها.

الإرجاع

Image: الصورة المُدرَجة

التفويض

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

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

insertImage(imageUrl)

تُدرِج هذه العلامة صورة في أعلى يمين الصفحة بحجم تلقائي من عنوان URL المقدَّم.

يؤدي إدراج الصورة إلى جلبها من عنوان URL مرة واحدة ويتم تخزين نسخة منها لعرضها داخل العرض التقديمي. يجب أن يكون حجم الصور أقل من 50 ميغابايت، وألّا يزيد عن 25 ميغابكسل، ويجب أن تكون بتنسيق PNG أو JPEG أو GIF.

يجب أن يكون عنوان URL المقدَّم متاحًا للجميع وألا يزيد حجمه عن 2 كيلوبايت. يتم حفظ عنوان URL نفسه مع الصورة وعرضها من خلال Image.getSourceUrl().

المعلمات

الاسمالنوعالوصف
imageUrlStringعنوان URL للصورة

الإرجاع

Image: الصورة المُدرَجة

التفويض

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

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

insertImage(imageUrl, left, top, width, height)

تُدرِج هذه العلامة صورة في الصفحة بالموضع والحجم المقدَّمين من عنوان URL المقدَّم.

يؤدي إدراج الصورة إلى جلبها من عنوان URL مرة واحدة ويتم تخزين نسخة منها لعرضها داخل العرض التقديمي. يجب أن يكون حجم الصور أقل من 50 ميغابايت، وألّا يزيد عن 25 ميغابكسل، ويجب أن تكون بتنسيق PNG أو JPEG أو GIF.

يجب أن يكون عنوان URL المقدَّم متاحًا للجميع وألا يزيد حجمه عن 2 كيلوبايت. يتم حفظ عنوان URL نفسه مع الصورة وعرضها من خلال Image.getSourceUrl().

للحفاظ على نسبة العرض إلى الارتفاع للصورة، يتم تعديل حجمها ووضعها في المنتصف بالاستناد إلى الحجم المقدَّم.

المعلمات

الاسمالنوعالوصف
imageUrlStringعنوان URL للصورة
leftNumberالموضع الأفقي للصورة بالنقاط، ويتم قياسه من أعلى يمين الصفحة.
topNumberالموضع العمودي للصورة بالنقاط، ويتم قياسه من أعلى يمين الصفحة.
widthNumberعرض الصورة بالنقاط
heightNumberارتفاع الصورة بالنقاط.

الإرجاع

Image: الصورة المُدرَجة

التفويض

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

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

insertLine(line)

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

يتم تحديد موضع العنصر المُدرَج في هذه الصفحة من موضع العنصر المصدر في صفحته المعنيّة.

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

إذا كان العنصر المقدَّم عنصر نائب يتم نسخه من عرض تقديمي مختلف، تتم نسخ الخصائص التي يتم اكتسابها من صفحات التنسيق أو الصفحات الرئيسية على العنصر من عرض التقديم المصدر. 

// Copy a line between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const line = otherPresentationSlide.getLines[0];
currentPresentationSlide.insertLine(line);

المعلمات

الاسمالنوعالوصف
lineLineالسطر الذي سيتم نسخه وإدراجه.

الإرجاع

Line: السطر الذي تم إدراجه

التفويض

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

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

insertLine(lineCategory, startConnectionSite, endConnectionSite)

تُدرج هذه العلامة خطًا في الصفحة يربط بين connection sites. يجب أن يكون الموقعان الإلكترونيان المرتبطَان بهذه الصفحة. 

// Insert a line in the first slide of the presentation connecting two shapes.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const shape1 = slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
const shape2 = slide.insertShape(SlidesApp.ShapeType.CLOUD);
slide.insertLine(
    SlidesApp.LineCategory.BENT,
    shape1.getConnectionSites()[0],
    shape2.getConnectionSites()[1],
);

المعلمات

الاسمالنوعالوصف
lineCategoryLineCategoryفئة السطر المطلوب إدراجه.
startConnectionSiteConnectionSiteموقع الربط الذي سيتم فيه ربط بداية الخط
endConnectionSiteConnectionSiteموقع الربط الذي سيتم فيه ربط نهاية الخط

الإرجاع

Line: السطر الذي تم إدراجه

التفويض

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

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

insertLine(lineCategory, startLeft, startTop, endLeft, endTop)

لإدراج سطر في الصفحة 

// Insert a line in the first slide of the presentation.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const startPoint = {
  left: 10,
  top: 10
};
const endPoint = {
  left: 40,
  top: 40
};
slide.insertLine(
    SlidesApp.LineCategory.STRAIGHT,
    startPoint.left,
    startPoint.top,
    endPoint.left,
    endPoint.top,
);

المعلمات

الاسمالنوعالوصف
lineCategoryLineCategoryفئة السطر المطلوب إدراجه.
startLeftNumberالموضع الأفقي لنقطة بداية الخط، ويتم قياسه بالنقاط من أعلى يمين الصفحة.
startTopNumberالموضع العمودي لنقطة بداية الخط، ويتم قياسه بالنقاط من أعلى يمين الصفحة.
endLeftNumberالموضع الأفقي لنقطة نهاية الخط، ويتم قياسه بالنقاط من أعلى يمين الصفحة.
endTopNumberالموضع العمودي لنقطة نهاية الخط، ويتم قياسه بالنقاط من أعلى يمين الصفحة.

الإرجاع

Line: السطر الذي تم إدراجه

التفويض

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

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

insertPageElement(pageElement)

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

يتم تحديد موضع العنصر المُدرَج في هذه الصفحة من موضع العنصر المصدر في صفحته المعنيّة.

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

إذا كان العنصر المقدَّم عنصر نائب يتم نسخه من عرض تقديمي مختلف، تتم نسخ الخصائص التي يتم اكتسابها من صفحات التنسيق أو الصفحات الرئيسية على العنصر من عرض التقديم المصدر. 

// Copy a page element between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const pageElement = otherPresentationSlide.getPageElements()[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertPageElement(pageElement);

المعلمات

الاسمالنوعالوصف
pageElementPageElementعنصر الصفحة الذي سيتم نسخه وإدراجه.

الإرجاع

PageElement: عنصر الصفحة الذي تم إدراجه

التفويض

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

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

insertShape(shape)

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

يتم تحديد موضع العنصر المُدرَج في هذه الصفحة من موضع العنصر المصدر في صفحته المعنيّة.

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

إذا كان العنصر المقدَّم عنصر نائب يتم نسخه من عرض تقديمي مختلف، تتم نسخ الخصائص التي يتم اكتسابها من صفحات التنسيق أو الصفحات الرئيسية على العنصر من عرض التقديم المصدر. 

// Copy a shape between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const shape = otherPresentationSlide.getShapes[0];
currentPresentationSlide.insertShape(
    shape);  // Also available for Layout, Master, and Page.

المعلمات

الاسمالنوعالوصف
shapeShapeالشكل الذي سيتم نسخه وإدراجه.

الإرجاع

Shape: الشكل الذي تم إدراجه

التفويض

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

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

insertShape(shapeType)

لإدراج شكل في الصفحة

يتم إدراج الشكل بحجم تلقائي في أعلى يمين الصفحة. 

// Insert a shape in the first slide of the presentation.
const slide = SlidesApp.getActivePresentation().getSlides()[0];

// Also available for Layout, Master, and Page.
slide.insertShape(SlidesApp.ShapeType.RECTANGLE);

المعلمات

الاسمالنوعالوصف
shapeTypeShapeTypeنوع الشكل المطلوب إدراجه.

الإرجاع

Shape: الشكل الذي تم إدراجه

التفويض

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

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

insertShape(shapeType, left, top, width, height)

لإدراج شكل في الصفحة

المعلمات

الاسمالنوعالوصف
shapeTypeShapeTypeنوع الشكل المطلوب إدراجه.
leftNumberالموضع الأفقي للشكل، ويتم قياسه من الزاوية العلوية اليسرى من الصفحة.
topNumberالموضع العمودي للشكل، ويتم قياسه من أعلى يمين الصفحة.
widthNumberعرض الشكل
heightNumberارتفاع الشكل

الإرجاع

Shape: الشكل الذي تم إدراجه

التفويض

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

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

insertSheetsChart(sourceChart)

تُدرج هذه الدالة رسمًا بيانيًا من "جداول بيانات Google" في الصفحة.

يتم إدراج الرسم البياني بحجم تلقائي في أعلى يمين الصفحة.

يرتبط الرسم البياني المُدرَج بالرسم البياني المصدر في "جداول بيانات Google"، ما يسمح بتعديله. يمكن للمتعاونين الآخرين رؤية الرابط الذي يؤدي إلى جدول البيانات المصدر. 

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertSheetsChart(chart);

المعلمات

الاسمالنوعالوصف
sourceChartEmbeddedChartالرسم البياني في جدول بيانات ليتم إدراجه في الصفحة

الإرجاع

SheetsChart: الرسم البياني المُدرَج في الصفحة

التفويض

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

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

insertSheetsChart(sourceChart, left, top, width, height)

تُدرج هذه الدالة رسمًا بيانيًا من "جداول بيانات Google" في الصفحة بالموضع والحجم المقدَّمين.

للحفاظ على نسبة العرض إلى الارتفاع للرسم البياني، يتم تصغير الرسم البياني وتوسيعه مع وضعه في المنتصف بحيث يتلاءم مع الحجم المقدَّم.

يرتبط الرسم البياني المُدرَج بالرسم البياني المصدر في "جداول بيانات Google"، ما يسمح بتعديله. يمكن للمتعاونين الآخرين رؤية الرابط الذي يؤدي إلى جدول البيانات المصدر. 

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const position = {
  left: 0,
  top: 0
};
const size = {
  width: 200,
  height: 200
};

// Also available for Layout, Master, and Page.
slide.insertSheetsChart(
    chart,
    position.left,
    position.top,
    size.width,
    size.height,
);

المعلمات

الاسمالنوعالوصف
sourceChartEmbeddedChartالرسم البياني في جدول بيانات ليتم إدراجه في الصفحة
leftNumberالموضع الأفقي للرسم البياني بالنقاط، ويتم قياسه من أعلى يمين الصفحة.
topNumberالموضع العمودي للرسم البياني بالنقاط، ويتم قياسه من أعلى يمين الصفحة.
widthNumberعرض الرسم البياني بالنقاط.
heightNumberارتفاع الرسم البياني بالنقاط.

الإرجاع

SheetsChart: الرسم البياني المُدرَج في الصفحة

التفويض

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

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

insertSheetsChart(sheetsChart)

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

يتم تحديد موضع العنصر المُدرَج في هذه الصفحة من موضع العنصر المصدر في صفحته المعنيّة.

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

إذا كان العنصر المقدَّم عنصر نائب يتم نسخه من عرض تقديمي مختلف، تتم نسخ الخصائص التي يتم اكتسابها من صفحات التنسيق أو الصفحات الرئيسية على العنصر من عرض التقديم المصدر. 

// Copy a sheets chart between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const sheetsChart = otherPresentationSlide.getSheetsCharts[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertSheetsChart(sheetsChart);

المعلمات

الاسمالنوعالوصف
sheetsChartSheetsChartالرسم البياني للجداول المطلوب نسخه وإدراجه

الإرجاع

SheetsChart: رسم بياني لأوراق البيانات المُدرَجة

التفويض

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

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

insertSheetsChartAsImage(sourceChart)

تُستخدَم هذه السمة لإدراج رسم بياني في "جداول بيانات Google" كعنصر Image في الصفحة.

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

الصورة المُدرجة للرسم البياني غير مرتبطة بالرسم البياني المصدر في "جداول بيانات Google". 

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertSheetsChartAsImage(
    chart);  // Also available for Layout, Master, and Page.

المعلمات

الاسمالنوعالوصف
sourceChartEmbeddedChartالرسم البياني في جدول بيانات ليتم إدراجه في الصفحة

الإرجاع

Image: صورة الرسم البياني المُدرَجة في الصفحة

التفويض

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

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

insertSheetsChartAsImage(sourceChart, left, top, width, height)

تُدرج هذه الدالة رسمًا بيانيًا من "جداول بيانات Google" كعنصر Image في الصفحة بالوضع والحجم المقدَّمين.

للحفاظ على نسبة العرض إلى الارتفاع لصورة الرسم البياني، يتم تعديل حجم الصورة ووضعها في المنتصف بالاستناد إلى الحجم المقدَّم.

الصورة المُدرجة للرسم البياني غير مرتبطة بالرسم البياني المصدر في "جداول بيانات Google". 

const sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
const chart = sheet.getCharts()[0];
// Insert the spreadsheet chart in the first slide.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
const position = {
  left: 0,
  top: 0
};
const size = {
  width: 200,
  height: 200
};

// Also available for Layout, Master, and Page.
slide.insertSheetsChartAsImage(
    chart,
    position.left,
    position.right,
    size.width,
    size.height,
);

المعلمات

الاسمالنوعالوصف
sourceChartEmbeddedChartالرسم البياني في جدول بيانات ليتم إدراجه في الصفحة
leftNumberالموضع الأفقي للرسم البياني بالنقاط، ويتم قياسه من أعلى يمين الصفحة.
topNumberالموضع العمودي للرسم البياني بالنقاط، ويتم قياسه من أعلى يمين الصفحة.
widthNumberعرض الرسم البياني بالنقاط.
heightNumberارتفاع الرسم البياني بالنقاط.

الإرجاع

Image: صورة الرسم البياني المُدرَجة في الصفحة

التفويض

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

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

insertTable(numRows, numColumns)

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

يكون الجدول في منتصف الصفحة بالحجم التلقائي مع صفوف وأعمدة موزّعة بالتساوي.

المعلمات

الاسمالنوعالوصف
numRowsIntegerعدد الصفوف في الجدول
numColumnsIntegerعدد الأعمدة في الجدول

الإرجاع

Table: الجدول المُدرَج

التفويض

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

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

insertTable(numRows, numColumns, left, top, width, height)

تُدرج هذه الدالة جدولاً في الصفحة بالموضع والحجم المقدَّمين.

يتم توزيع الصفوف والأعمدة بالتساوي في الجدول الذي تم إنشاؤه.

المعلمات

الاسمالنوعالوصف
numRowsIntegerعدد الصفوف في الجدول
numColumnsIntegerعدد الأعمدة في الجدول
leftNumberالموضع الأفقي للجدول، ويتم قياسه من أعلى يمين الصفحة.
topNumberالموضع العمودي للجدول، ويتم قياسه من أعلى يمين الصفحة.
widthNumberعرض الجدول.
heightNumberالحد الأدنى لارتفاع الجدول يعتمد الارتفاع الفعلي للجدول المعروض على عوامل مثل حجم خط النص.

الإرجاع

Table: الجدول المُدرَج

التفويض

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

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

insertTable(table)

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

يتم تحديد موضع العنصر المُدرَج في هذه الصفحة من موضع العنصر المصدر في صفحته المعنيّة.

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

إذا كان العنصر المقدَّم عنصر نائب يتم نسخه من عرض تقديمي مختلف، تتم نسخ الخصائص التي يتم اكتسابها من صفحات التنسيق أو الصفحات الرئيسية على العنصر من عرض التقديم المصدر. 

// Copy a table between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const table = otherPresentationSlide.getTables[0];
currentPresentationSlide.insertTable(
    table);  // Also available for Layout, Master, and Page.

المعلمات

الاسمالنوعالوصف
tableTableالجدول الذي سيتم نسخه وإدراجه

الإرجاع

Table: الجدول المُدرَج

التفويض

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

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

insertTextBox(text)

تُدرج هذه الدالة مربّع نص Shape يحتوي على السلسلة المقدَّمة في الصفحة.

يتم إدراج شكل مربّع النص بحجم تلقائي في أعلى يمين الصفحة. 

// Insert text box with "Hello" on the first slide of presentation.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertTextBox('Hello');  // Also available for Layout, Master, and Page.

المعلمات

الاسمالنوعالوصف
textStringالسلسلة التي يجب أن يحتوي عليها شكل مربّع النص

الإرجاع

Shape - شكل مربّع النص المُدرَج

التفويض

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

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

insertTextBox(text, left, top, width, height)

تُدرج هذه الدالة مربّع نص Shape يحتوي على السلسلة المقدَّمة في الصفحة. 

// Insert text box with "Hello" on the first slide of presentation. This text
// box is a square with a length of 10 points on each side.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.insertTextBox(
    'Hello', 0, 0, 10, 10);  // Also available for Layout, Master, and Page.

المعلمات

الاسمالنوعالوصف
textStringالسلسلة التي يجب أن يحتوي عليها شكل مربّع النص
leftNumberالموضع الأفقي لشكل مربّع النص، ويتم قياسه من أعلى يمين الصفحة.
topNumberالموضع العمودي لشكل مربّع النص، ويتم قياسه من أعلى يمين الصفحة.
widthNumberعرض شكل مربّع النص
heightNumberارتفاع شكل مربّع النص

الإرجاع

Shape - شكل مربّع النص المُدرَج

التفويض

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

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

insertVideo(videoUrl)

تُدرج هذه الأداة فيديو بحجم تلقائي في أعلى يمين الصفحة.

لا تتوفّر حاليًا سوى فيديوهات YouTube.

المعلمات

الاسمالنوعالوصف
videoUrlStringعنوان URL للفيديو المطلوب إدراجه.

الإرجاع

Video: الفيديو المُدرَج

التفويض

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

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

insertVideo(videoUrl, left, top, width, height)

تُدرج هذه الدالة فيديو في الصفحة بالموضع والحجم المقدَّمين.

لا تتوفّر حاليًا سوى فيديوهات YouTube.

المعلمات

الاسمالنوعالوصف
videoUrlStringعنوان URL للفيديو المطلوب إدراجه.
leftNumberالموضع الأفقي للفيديو بالنقاط، ويتم قياسه من أعلى يمين الصفحة.
topNumberالموضع العمودي للفيديو بالنقاط، ويتم قياسه من أعلى يمين الصفحة.
widthNumberعرض الفيديو بالنقاط
heightNumberارتفاع الفيديو بالنقاط

الإرجاع

Video: الفيديو المُدرَج

التفويض

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

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

insertVideo(video)

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

يتم تحديد موضع العنصر المُدرَج في هذه الصفحة من موضع العنصر المصدر في صفحته المعنيّة.

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

إذا كان العنصر المقدَّم عنصر نائب يتم نسخه من عرض تقديمي مختلف، تتم نسخ الخصائص التي يتم اكتسابها من صفحات التنسيق أو الصفحات الرئيسية على العنصر من عرض التقديم المصدر. 

// Copy a video between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const video = otherPresentationSlide.getVideos[0];
currentPresentationSlide.insertVideo(
    video);  // Also available for Layout, Master, and Page.

المعلمات

الاسمالنوعالوصف
videoVideoالفيديو المطلوب نسخه وإدراجه

الإرجاع

Video: الفيديو المُدرَج

التفويض

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

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

insertWordArt(wordArt)

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

يتم تحديد موضع العنصر المُدرَج في هذه الصفحة من موضع العنصر المصدر في صفحته المعنيّة.

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

إذا كان العنصر المقدَّم عنصر نائب يتم نسخه من عرض تقديمي مختلف، تتم نسخ الخصائص التي يتم اكتسابها من صفحات التنسيق أو الصفحات الرئيسية على العنصر من عرض التقديم المصدر. 

// Copy a word art between presentations.
const otherPresentationSlide =
    SlidesApp.openById('presentationId').getSlides()[0];
const currentPresentationSlide =
    SlidesApp.getActivePresentation().getSlides()[0];
const wordArt = otherPresentationSlide.getWordArts[0];

// Also available for Layout, Master, and Page.
currentPresentationSlide.insertWordArt(wordArt);

المعلمات

الاسمالنوعالوصف
wordArtWordArtالمجموعة التي سيتمّ نسخها وإدراجها.

الإرجاع

WordArt: عنصر word art الذي تم إدراجه

التفويض

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

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

remove()

إزالة الصفحة

التفويض

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

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

replaceAllText(findText, replaceText)

استبدال جميع تكرارات النص الذي يتطابق مع النص المراد البحث عنه بالنص البديل البحث غير حساس لحالة الأحرف.

المعلمات

الاسمالنوعالوصف
findTextStringالنص المطلوب البحث عنه.
replaceTextStringالنص الذي سيتم استبدال النص المطابق به.

الإرجاع

Integer - تم تغيير عدد مرات التكرار

التفويض

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

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

replaceAllText(findText, replaceText, matchCase)

استبدال جميع تكرارات النص الذي يتطابق مع النص المراد البحث عنه بالنص البديل

المعلمات

الاسمالنوعالوصف
findTextStringالنص المطلوب البحث عنه.
replaceTextStringالنص الذي سيتم استبدال النص المطابق به.
matchCaseBooleanإذا كان الخيار true، يكون البحث حسّاسًا لحالة الأحرف. وإذا كان الخيار false، يكون البحث غير حسّاس لحالة الأحرف.

الإرجاع

Integer - تم تغيير عدد مرات التكرار

التفويض

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

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

selectAsCurrentPage()

لاختيار Page في العرض النشط كـ current page selection وإزالة أي اختيار سابق

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

// Select the first slide as the current page selection and replace any previous
// selection.
const slide = SlidesApp.getActivePresentation().getSlides()[0];
slide.selectAsCurrentPage();  // Also available for Layout, Master, and Page.

التفويض

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

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