ماجستير في عرض تقديمي.
تحتوي النماذج الرئيسية على جميع عناصر الصفحة الشائعة والخصائص الشائعة لمجموعة من التخطيطات. إنها تخدم ثلاثة أغراض:
- تحتوي أشكال العناصر النائبة في شريحة رئيسية على أنماط النص التلقائية وخصائص الأشكال لجميع أشكال العناصر النائبة على الصفحات التي تستخدم هذه الشريحة الرئيسية.
- تحدد خصائص الصفحة الرئيسية الخصائص الشائعة للصفحة الموروثة من خلال تخطيطاتها.
- تظهر أي أشكال أخرى في الشريحة الرئيسية في جميع الشرائح التي تستخدم هذه الشريحة الرئيسية، بغض النظر عن تنسيقها.
الطُرق
الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
---|---|---|
getBackground() | PageBackground | للحصول على خلفية الصفحة. |
getColorScheme() | ColorScheme | للحصول على ColorScheme المرتبط بالصفحة. |
getGroups() | Group[] | تعرض قائمة من عناصر Group على الصفحة. |
getImages() | Image[] | تعرض قائمة من عناصر Image على الصفحة. |
getLayouts() | Layout[] | الحصول على تخطيطات هذه الشريحة الرئيسية. |
getLines() | Line[] | تعرض قائمة من عناصر Line على الصفحة. |
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()
getImages()
getLayouts()
getLines()
getObjectId()
الحصول على المعرّف الفريد للصفحة تتشارك معرفات العناصر التي تستخدمها الصفحات وعناصر الصفحة نفس مساحة الاسم.
استرجاع الكرة
String
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageElementById(id)
لعرض PageElement
على الصفحة بالمعرّف المحدّد، أو عرض null
في حال عدم وجود أي معرّف.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
id | String | معرّف عنصر الصفحة الذي يتم استرداده |
استرجاع الكرة
PageElement
- عنصر الصفحة الذي يحمل المعرّف المحدّد
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageElements()
تعرض قائمة بالعناصر PageElement
من العناصر المعروضة على الصفحة.
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPageType()
getPlaceholder(placeholderType)
تعرض العنصر النائب PageElement
لعنصر PlaceholderType
محدّد أو null
محدّد في حال عدم توفّر عنصر نائب مطابق.
إذا كانت هناك عناصر نائبة متعددة من النوع نفسه، يتم عرض العنصر النائب الذي يتضمّن الحد الأدنى من فهرس العنصر النائب. وإذا كانت هناك عدة عناصر نائبة مطابقة لها الفهرس نفسه، سيتم عرض العنصر النائب الأول من مجموعة عناصر الصفحة الخاصة بالصفحة.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; var placeholder = slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
placeholderType | PlaceholderType |
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPlaceholder(placeholderType, placeholderIndex)
لعرض كائن العنصر النائب PageElement
لـ PlaceholderType
محدد وفهرس عنصر نائب،
أو null
إذا لم يكن العنصر النائب متوفرًا.
إذا كانت هناك عناصر نائبة متعددة من النوع والفهرس نفسهما، سيتم عرض العنصر النائب الأول من مجموعة عناصر الصفحة الخاصة بالصفحة.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; var placeholder = slide.getPlaceholder(SlidesApp.PlaceholderType.CENTERED_TITLE, 0);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
placeholderType | PlaceholderType | |
placeholderIndex | Integer |
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getPlaceholders()
تعرض قائمة بالعناصر النائبة PageElement
في الصفحة.
var master = SlidesApp.getActivePresentation().getMasters()[0]; Logger.log('Number of placeholders in the master: ' + master.getPlaceholders().length);
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getShapes()
getSheetsCharts()
تعرض قائمة من عناصر SheetsChart
على الصفحة.
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getTables()
getVideos()
getWordArts()
group(pageElements)
تعمل هذه السمة على تجميع كل عناصر الصفحة المحدّدة.
يجب أن يكون هناك عنصري صفحة على الأقل في نفس الصفحة وليسا بالفعل في مجموعة أخرى. يتعذّر تجميع بعض عناصر الصفحة، مثل Videos
وTables
وplaceholder Shapes
.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
pageElements | PageElement[] | العناصر المطلوب تجميعها معًا. |
استرجاع الكرة
Group
: المجموعة الجديدة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertGroup(group)
يدرج نسخة من Group
المقدمة في الصفحة.
يتم تحديد موضع العنصر المصدر على هذه الصفحة من موضع العنصر المصدر على الصفحة الخاصة به.
إذا كان العنصر المقدّم عبارة عن عنصر نائب يتم نسخه من داخل العرض التقديمي الحالي، فإن الخصائص التي تكتسبها من الصفحات الرئيسية أو صفحات التنسيق تكتسبها أيضًا من العنصر المدرج.
إذا كان العنصر المقدّم عبارة عن عنصر نائب يتم نسخه من عرض تقديمي مختلف، فسيتم نسخ الخصائص التي تكتسبها من الصفحة الرئيسية أو صفحات التنسيق إلى العنصر من العرض التقديمي المصدر.
// Copy a group between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var group = otherPresentationSlide.getGroups()[0]; currentPresentationSlide.insertGroup(group); // Also available for Layout, Master, and Page.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
group | Group | المجموعة التي سيتم نسخها وإدراجها |
استرجاع الكرة
Group
— المجموعة المدرجة.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertImage(blobSource)
يدرج صورة في الجانب العلوي الأيسر من الصفحة بحجم تلقائي من حجم الصورة المكعبة المحدد.
عند إدراج الصورة، يتم جلبها من BlobSource
مرة واحدة، كما يتم تخزين نسخة لعرضها في العرض التقديمي. يجب أن يكون حجم الصور أقل من 50 ميغابايت، ولا يمكن أن يتجاوز
25 ميغابكسل، ويجب أن تكون بتنسيق PNG أو JPEG أو GIF.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; // Get the Drive image file with the given ID. var image = DriveApp.getFileById(fileId); slide.insertImage(image);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
blobSource | BlobSource | بيانات الصورة |
استرجاع الكرة
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.
للحفاظ على نسبة العرض إلى الارتفاع للصورة، يتم تغيير حجم الصورة وتوسيطها بالنسبة إلى الحجم المقدم.
var slide = SlidesApp.getActivePresentation().getSlides()[0]; // Get the Drive image file with the given ID. var image = DriveApp.getFileById(fileId); var position = {left: 0, top: 0}; var size = {width: 300, height: 100}; slide.insertImage(image, position.left, position.top, size.width, size.height);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
blobSource | BlobSource | بيانات الصورة |
left | Number | تمثّل هذه السمة الموضع الأفقي للصورة بالنقاط، ويتم قياسه من أعلى يمين الصفحة. |
top | Number | تمثّل هذه السمة الموضع الرأسي للصورة بالنقاط، ويتم قياسه في أعلى يمين الصفحة. |
width | Number | عرض الصورة بالنقاط. |
height | Number | ارتفاع الصورة بالنقاط. |
استرجاع الكرة
Image
— الصورة المدرجة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertImage(image)
يدرج نسخة من Image
المقدمة في الصفحة.
يتم تحديد موضع الصور المدرجة في هذه الصفحة من موضع الصورة المصدر على الصفحة المعنية.
إذا كانت الصورة المقدّمة عبارة عن عنصر نائب يتم نسخه من داخل العرض التقديمي الحالي، إنّ الخصائص التي تكتسبها من الصفحات الرئيسية أو صفحات التنسيق تكتسبها أيضًا الصورة المُدرَجة.
إذا كانت الصورة المقدّمة عبارة عن عنصر نائب يتم نسخه من عرض تقديمي مختلف، سيتم نسخ الخصائص المكتسبة من الصفحات الرئيسية أو صفحات التنسيق إلى الصورة من العرض التقديمي المصدر. إذا كانت صورة العنصر النائب المنسوخة فارغة، لن يتم إدراج أي شيء في العرض التقديمي الوجهة.
// Copy an image between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var image = otherPresentationSlide.getImages[0]; currentPresentationSlide.insertImage(image);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
image | Image | الصورة التي سيتم نسخها وإدراجها |
استرجاع الكرة
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()
.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
imageUrl | String | عنوان 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()
.
للحفاظ على نسبة العرض إلى الارتفاع للصورة، يتم تغيير حجم الصورة وتوسيطها بالنسبة إلى الحجم المقدم.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
imageUrl | String | عنوان URL للصورة |
left | Number | تمثّل هذه السمة الموضع الأفقي للصورة بالنقاط، ويتم قياسه من أعلى يمين الصفحة. |
top | Number | تمثّل هذه السمة الموضع الرأسي للصورة بالنقاط، ويتم قياسه في أعلى يمين الصفحة. |
width | Number | عرض الصورة بالنقاط. |
height | Number | ارتفاع الصورة بالنقاط. |
استرجاع الكرة
Image
— الصورة المدرجة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertLine(line)
يدرج نسخة من Line
المقدمة في الصفحة.
يتم تحديد موضع العنصر المصدر على هذه الصفحة من موضع العنصر المصدر على الصفحة الخاصة به.
إذا كان العنصر المقدّم عبارة عن عنصر نائب يتم نسخه من داخل العرض التقديمي الحالي، فإن الخصائص التي تكتسبها من الصفحات الرئيسية أو صفحات التنسيق تكتسبها أيضًا من العنصر المدرج.
إذا كان العنصر المقدّم عبارة عن عنصر نائب يتم نسخه من عرض تقديمي مختلف، فسيتم نسخ الخصائص التي تكتسبها من الصفحة الرئيسية أو صفحات التنسيق إلى العنصر من العرض التقديمي المصدر.
// Copy a line between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var line = otherPresentationSlide.getLines[0]; currentPresentationSlide.insertLine(line);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
line | Line | السطر المطلوب نسخه وإدراجه. |
استرجاع الكرة
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. var slide = SlidesApp.getActivePresentation().getSlides()[0]; var shape1 = slide.insertShape(SlidesApp.ShapeType.RECTANGLE); var shape2 = slide.insertShape(SlidesApp.ShapeType.CLOUD); slide.insertLine( SlidesApp.LineCategory.BENT, shape1.getConnectionSites()[0], shape2.getConnectionSites()[1]);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
lineCategory | LineCategory | فئة الخط المطلوب إدراجه. |
startConnectionSite | ConnectionSite | موقع الربط الذي سيتم توصيل بداية السطر به. |
endConnectionSite | ConnectionSite | موقع الربط الذي سيتم توصيل نهاية السطر به. |
استرجاع الكرة
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. var slide = SlidesApp.getActivePresentation().getSlides()[0]; var startPoint = {left: 10, top: 10}; var endPoint = {left: 40, top: 40}; slide.insertLine( SlidesApp.LineCategory.STRAIGHT, startPoint.left, startPoint.top, endPoint.left, endPoint.top);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
lineCategory | LineCategory | فئة الخط المطلوب إدراجه. |
startLeft | Number | تمثّل هذه السمة الموضع الأفقي لنقطة بداية الخط، ويتم قياسه بالنقاط الواقعة في أعلى يمين الصفحة. |
startTop | Number | تمثّل هذه السمة الموضع الرأسي لنقطة بداية الخط، ويتم قياسه بالنقاط من أعلى يمين الصفحة. |
endLeft | Number | تمثّل هذه السمة الموضع الأفقي لنقطة نهاية الخط، ويتم قياسه بالنقاط الواقعة في أعلى يسار الصفحة. |
endTop | Number | الموضع الرأسي لنقطة نهاية الخط، ويتم قياسه بالنقاط من أعلى يمين الصفحة. |
استرجاع الكرة
Line
— السطر المدرج.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertPageElement(pageElement)
يدرج نسخة من PageElement
المقدمة في الصفحة.
يتم تحديد موضع العنصر المصدر على هذه الصفحة من موضع العنصر المصدر على الصفحة الخاصة به.
إذا كان العنصر المقدّم عبارة عن عنصر نائب يتم نسخه من داخل العرض التقديمي الحالي، فإن الخصائص التي تكتسبها من الصفحات الرئيسية أو صفحات التنسيق تكتسبها أيضًا من العنصر المدرج.
إذا كان العنصر المقدّم عبارة عن عنصر نائب يتم نسخه من عرض تقديمي مختلف، فسيتم نسخ الخصائص التي تكتسبها من الصفحة الرئيسية أو صفحات التنسيق إلى العنصر من العرض التقديمي المصدر.
// Copy a page element between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var pageElement = otherPresentationSlide.getPageElements()[0]; // Also available for Layout, Master, and Page. currentPresentationSlide.insertPageElement(pageElement);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
pageElement | PageElement | عنصر الصفحة المراد نسخه وإدراجه |
استرجاع الكرة
PageElement
— عنصر الصفحة الذي تم إدراجه
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertShape(shape)
يدرج نسخة من Shape
المقدمة في الصفحة.
يتم تحديد موضع العنصر المصدر على هذه الصفحة من موضع العنصر المصدر على الصفحة الخاصة به.
إذا كان العنصر المقدّم عبارة عن عنصر نائب يتم نسخه من داخل العرض التقديمي الحالي، فإن الخصائص التي تكتسبها من الصفحات الرئيسية أو صفحات التنسيق تكتسبها أيضًا من العنصر المدرج.
إذا كان العنصر المقدّم عبارة عن عنصر نائب يتم نسخه من عرض تقديمي مختلف، فسيتم نسخ الخصائص التي تكتسبها من الصفحة الرئيسية أو صفحات التنسيق إلى العنصر من العرض التقديمي المصدر.
// Copy a shape between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var shape = otherPresentationSlide.getShapes[0]; currentPresentationSlide.insertShape(shape); // Also available for Layout, Master, and Page.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
shape | Shape | الشكل المراد نسخه وإدراجه. |
استرجاع الكرة
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. var slide = SlidesApp.getActivePresentation().getSlides()[0]; // Also available for Layout, Master, and Page. slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
shapeType | ShapeType | نوع الشكل المراد إدراجه. |
استرجاع الكرة
Shape
— الشكل الذي تم إدراجه
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertShape(shapeType, left, top, width, height)
يدرج شكلاً على الصفحة.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
shapeType | ShapeType | نوع الشكل المراد إدراجه. |
left | Number | تمثّل هذه السمة الموضع الأفقي للشكل، ويتم قياسه من أعلى يمين الصفحة. |
top | Number | الموضع الرأسي للشكل، ويتم قياسه من الزاوية اليمنى العليا للصفحة. |
width | Number | عرض الشكل. |
height | Number | ارتفاع الشكل. |
استرجاع الكرة
Shape
— الشكل الذي تم إدراجه
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSheetsChart(sourceChart)
يدرج مخطط "جداول بيانات Google" في الصفحة.
يتم إدراج الرسم البياني بالحجم التلقائي في أعلى يمين الصفحة.
يرتبط المخطط المدرج بمخطط جداول بيانات Google المصدر الذي يسمح بتحديثه. يمكن للمتعاونين الآخرين رؤية الرابط المؤدي إلى جدول البيانات المصدر.
var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; var chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. var slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertSheetsChart(chart);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
sourceChart | EmbeddedChart | المخطط في جدول بيانات سيتم إدراجه في الصفحة. |
استرجاع الكرة
SheetsChart
— الرسم البياني الذي تم إدراجه في الصفحة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSheetsChart(sourceChart, left, top, width, height)
يدرج مخططًا لـ "جداول بيانات Google" على الصفحة بالموضع والحجم المقدمين.
للحفاظ على نسبة العرض إلى الارتفاع للرسم البياني، يتم تغيير حجم المخطط وتوسيطه بالنسبة إلى الحجم المقدم.
يرتبط المخطط المدرج بمخطط جداول بيانات Google المصدر الذي يسمح بتحديثه. يمكن للمتعاونين الآخرين رؤية الرابط المؤدي إلى جدول البيانات المصدر.
var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; var chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. var slide = SlidesApp.getActivePresentation().getSlides()[0]; var position = {left: 0, top: 0}; var size = {width: 200, height: 200}; // Also available for Layout, Master, and Page. slide.insertSheetsChart( chart, position.left, position.top, size.width, size.height);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
sourceChart | EmbeddedChart | المخطط في جدول بيانات سيتم إدراجه في الصفحة. |
left | Number | الموضع الأفقي للرسم البياني بالنقاط، ويتم قياسه من أعلى يمين الصفحة. |
top | Number | الموضع الرأسي للرسم البياني بالنقاط، ويتم قياسه من أعلى يمين الصفحة. |
width | Number | تمثّل هذه السمة عرض الرسم البياني بالنقاط. |
height | Number | ارتفاع الرسم البياني بالنقاط |
استرجاع الكرة
SheetsChart
— الرسم البياني الذي تم إدراجه في الصفحة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSheetsChart(sheetsChart)
يدرج نسخة من SheetsChart
المقدمة في الصفحة.
يتم تحديد موضع العنصر المصدر على هذه الصفحة من موضع العنصر المصدر على الصفحة الخاصة به.
إذا كان العنصر المقدّم عبارة عن عنصر نائب يتم نسخه من داخل العرض التقديمي الحالي، فإن الخصائص التي تكتسبها من الصفحات الرئيسية أو صفحات التنسيق تكتسبها أيضًا من العنصر المدرج.
إذا كان العنصر المقدّم عبارة عن عنصر نائب يتم نسخه من عرض تقديمي مختلف، فسيتم نسخ الخصائص التي تكتسبها من الصفحة الرئيسية أو صفحات التنسيق إلى العنصر من العرض التقديمي المصدر.
// Copy a sheets chart between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var sheetsChart = otherPresentationSlide.getSheetsCharts[0]; // Also available for Layout, Master, and Page. currentPresentationSlide.insertSheetsChart(sheetsChart);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
sheetsChart | SheetsChart | مخططات الأوراق التي سيتم نسخها وإدراجها. |
استرجاع الكرة
SheetsChart
— الرسم البياني للأوراق المدرجة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSheetsChartAsImage(sourceChart)
يدرج رسمًا بيانيًا من "جداول بيانات Google" باعتباره Image
في الصفحة.
يتم إدراج صورة المخطط بالحجم الافتراضي في أعلى الجانب الأيسر من الصفحة.
لم يتم ربط صورة الرسم البياني المدرجة بمخطط "جداول بيانات Google" المصدر.
var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; var chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. var slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertSheetsChartAsImage(chart); // Also available for Layout, Master, and Page.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
sourceChart | EmbeddedChart | المخطط في جدول بيانات سيتم إدراجه في الصفحة. |
استرجاع الكرة
Image
- صورة الرسم البياني المدرجة في الصفحة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertSheetsChartAsImage(sourceChart, left, top, width, height)
يدرج مخطط "جداول بيانات Google" بتنسيق Image
على الصفحة بالموضع والحجم المقدمين.
للحفاظ على نسبة العرض إلى الارتفاع لصورة الرسم البياني، يتم تغيير حجم الصورة وتوسيطها مع مراعاة الحجم المقدم.
لم يتم ربط الصورة المدرجة للرسم البياني بمخطط "جداول بيانات Google" المصدر.
var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0]; var chart = sheet.getCharts()[0]; // Insert the spreadsheet chart in the first slide. var slide = SlidesApp.getActivePresentation().getSlides()[0]; var position = {left: 0, top: 0}; var size = {width: 200, height: 200}; // Also available for Layout, Master, and Page. slide.insertSheetsChartAsImage( chart, position.left, position.right, size.width, size.height);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
sourceChart | EmbeddedChart | المخطط في جدول بيانات سيتم إدراجه في الصفحة. |
left | Number | الموضع الأفقي للرسم البياني بالنقاط، ويتم قياسه من أعلى يمين الصفحة. |
top | Number | الموضع الرأسي للرسم البياني بالنقاط، ويتم قياسه من أعلى يمين الصفحة. |
width | Number | تمثّل هذه السمة عرض الرسم البياني بالنقاط. |
height | Number | ارتفاع الرسم البياني بالنقاط |
استرجاع الكرة
Image
- صورة الرسم البياني المدرجة في الصفحة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertTable(numRows, numColumns)
إدراج جدول في الصفحة
يوضع الجدول في وسط الصفحة بالحجم التلقائي والصفوف والأعمدة الموزَّعة بالتساوي.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
numRows | Integer | عدد الصفوف في الجدول. |
numColumns | Integer | عدد الأعمدة في الجدول. |
استرجاع الكرة
Table
— الجدول الذي تم إدراجه
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertTable(numRows, numColumns, left, top, width, height)
يدرج جدولاً على الصفحة بالموضع والحجم المقدمين.
يتم توزيع الصفوف والأعمدة بالتساوي في الجدول الذي تم إنشاؤه.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
numRows | Integer | عدد الصفوف في الجدول. |
numColumns | Integer | عدد الأعمدة في الجدول. |
left | Number | الموضع الأفقي للجدول، ويتم قياسه من أعلى يمين الصفحة. |
top | Number | الموضع العمودي للجدول، ويتم قياسه من أعلى يمين الصفحة. |
width | Number | تمثّل هذه السمة عرض الجدول. |
height | Number | تمثّل هذه السمة الحد الأدنى لارتفاع الجدول. يعتمد الارتفاع الفعلي للجدول المعروض على عوامل مثل حجم خط النص. |
استرجاع الكرة
Table
— الجدول الذي تم إدراجه
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertTable(table)
يدرج نسخة من Table
المقدمة في الصفحة.
يتم تحديد موضع العنصر المصدر على هذه الصفحة من موضع العنصر المصدر على الصفحة الخاصة به.
إذا كان العنصر المقدّم عبارة عن عنصر نائب يتم نسخه من داخل العرض التقديمي الحالي، فإن الخصائص التي تكتسبها من الصفحات الرئيسية أو صفحات التنسيق تكتسبها أيضًا من العنصر المدرج.
إذا كان العنصر المقدّم عبارة عن عنصر نائب يتم نسخه من عرض تقديمي مختلف، فسيتم نسخ الخصائص التي تكتسبها من الصفحة الرئيسية أو صفحات التنسيق إلى العنصر من العرض التقديمي المصدر.
// Copy a table between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var table = otherPresentationSlide.getTables[0]; currentPresentationSlide.insertTable(table); // Also available for Layout, Master, and Page.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
table | Table | الجدول الذي سيتم نسخه وإدراجه. |
استرجاع الكرة
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. var slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertTextBox('Hello'); // Also available for Layout, Master, and Page.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
text | String | السلسلة التي يجب أن يحتوي عليها شكل مربع النص. |
استرجاع الكرة
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. var slide = SlidesApp.getActivePresentation().getSlides()[0]; slide.insertTextBox('Hello', 0, 0, 10, 10); // Also available for Layout, Master, and Page.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
text | String | السلسلة التي يجب أن يحتوي عليها شكل مربع النص. |
left | Number | تمثّل هذه السمة الموضع الأفقي لشكل مربّع النص، ويتم قياسه من أعلى يمين الصفحة. |
top | Number | الموضع الرأسي لشكل مربّع النص، ويتم قياسه من أعلى يمين الصفحة. |
width | Number | تمثّل هذه السمة عرض شكل مربّع النص. |
height | Number | ارتفاع شكل مربّع النص. |
استرجاع الكرة
Shape
— شكل مربّع النص الذي تم إدراجه
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertVideo(videoUrl)
يدرج فيديو بحجم تلقائي في أعلى يمين الصفحة.
تتوفّر حاليًا فيديوهات YouTube فقط.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
videoUrl | String | تمثّل هذه السمة عنوان URL للفيديو المطلوب إدراجه. |
استرجاع الكرة
Video
— الفيديو الذي تم إدراجه
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertVideo(videoUrl, left, top, width, height)
يدرج فيديو على الصفحة مع الموضع والحجم المقدمين.
تتوفّر حاليًا فيديوهات YouTube فقط.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
videoUrl | String | تمثّل هذه السمة عنوان URL للفيديو المطلوب إدراجه. |
left | Number | تمثّل هذه السمة الموضع الأفقي للفيديو بالنقاط، ويتم قياسه في الزاوية العلوية اليمنى من الصفحة. |
top | Number | الموضع العمودي للفيديو بالنقاط، ويتم قياسه في أعلى يمين الصفحة. |
width | Number | تمثّل هذه السمة عرض الفيديو بالنقاط. |
height | Number | تمثّل هذه السمة ارتفاع الفيديو بالنقاط. |
استرجاع الكرة
Video
— الفيديو الذي تم إدراجه
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertVideo(video)
يدرج نسخة من Video
المقدمة في الصفحة.
يتم تحديد موضع العنصر المصدر على هذه الصفحة من موضع العنصر المصدر على الصفحة الخاصة به.
إذا كان العنصر المقدّم عبارة عن عنصر نائب يتم نسخه من داخل العرض التقديمي الحالي، فإن الخصائص التي تكتسبها من الصفحات الرئيسية أو صفحات التنسيق تكتسبها أيضًا من العنصر المدرج.
إذا كان العنصر المقدّم عبارة عن عنصر نائب يتم نسخه من عرض تقديمي مختلف، فسيتم نسخ الخصائص التي تكتسبها من الصفحة الرئيسية أو صفحات التنسيق إلى العنصر من العرض التقديمي المصدر.
// Copy a video between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var video = otherPresentationSlide.getVideos[0]; currentPresentationSlide.insertVideo(video); // Also available for Layout, Master, and Page.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
video | Video | الفيديو المراد نسخه وإدراجه. |
استرجاع الكرة
Video
— الفيديو الذي تم إدراجه
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertWordArt(wordArt)
يدرج نسخة من WordArt
المقدمة في الصفحة.
يتم تحديد موضع العنصر المصدر على هذه الصفحة من موضع العنصر المصدر على الصفحة الخاصة به.
إذا كان العنصر المقدّم عبارة عن عنصر نائب يتم نسخه من داخل العرض التقديمي الحالي، فإن الخصائص التي تكتسبها من الصفحات الرئيسية أو صفحات التنسيق تكتسبها أيضًا من العنصر المدرج.
إذا كان العنصر المقدّم عبارة عن عنصر نائب يتم نسخه من عرض تقديمي مختلف، فسيتم نسخ الخصائص التي تكتسبها من الصفحة الرئيسية أو صفحات التنسيق إلى العنصر من العرض التقديمي المصدر.
// Copy a word art between presentations. var otherPresentationSlide = SlidesApp.openById('presentationId').getSlides()[0]; var currentPresentationSlide = SlidesApp.getActivePresentation().getSlides()[0]; var wordArt = otherPresentationSlide.getWordArts[0]; // Also available for Layout, Master, and Page. currentPresentationSlide.insertWordArt(wordArt);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
wordArt | WordArt | المجموعة التي سيتم نسخها وإدراجها |
استرجاع الكرة
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)
لاستبدال جميع تكرارات النص المطابق للبحث عن النص باستبدال النص. فإن البحث غير حساس لحالة الأحرف.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
findText | String | النص المطلوب البحث عنه |
replaceText | String | النص المطلوب استبدال النص المطابق له. |
استرجاع الكرة
Integer
- تم تغيير عدد التكرارات
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceAllText(findText, replaceText, matchCase)
لاستبدال جميع تكرارات النص المطابق للبحث عن النص باستبدال النص.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
findText | String | النص المطلوب البحث عنه |
replaceText | String | النص المطلوب استبدال النص المطابق له. |
matchCase | Boolean | إذا كان البحث 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. var 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