این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Class SlidesApp

Presentations قابل ویرایش را ایجاد و باز می کند.

// Open a presentation by ID.
var preso = SlidesApp.openById('PRESENTATION_ID_GOES_HERE');

// Create and open a presentation.
preso = SlidesApp.create('Presentation Name');

خواص

ویژگی	تایپ کنید	شرح
`AlignmentPosition`	`AlignmentPosition`	شمارشی از انواع موقعیت های تراز.
`ArrowStyle`	`ArrowStyle`	شمارشی از سبک های مختلف پیکانی که یک `Line` می تواند داشته باشد.
`AutoTextType`	`AutoTextType`	شمارشی از انواع متن خودکار.
`AutofitType`	`AutofitType`	شمارشی از انواع خودکار.
`CellMergeState`	`CellMergeState`	شمارشی از حالات مختلف ادغام یک سلول جدول.
`ColorType`	`ColorType`	شمارش انواع رنگ
`ContentAlignment`	`ContentAlignment`	شمارشی از مقادیر مورد استفاده برای تعیین تراز محتوا.
`DashStyle`	`DashStyle`	شمارشی از سبک های مختلف خط تیره که یک `Line` می تواند داشته باشد.
`FillType`	`FillType`	شمارش انواع پر.
`LineCategory`	`LineCategory`	شمارشی از دسته های `Line` .
`LineFillType`	`LineFillType`	شمارشی از انواع `LineFill` .
`LineType`	`LineType`	شمارشی از انواع `Line` .
`LinkType`	`LinkType`	شمارشی از انواع پیوندها.
`ListPreset`	`ListPreset`	شمارشی از انواع از پیش تنظیم لیست.
`PageBackgroundType`	`PageBackgroundType`	شمارشی از انواع پس زمینه صفحه.
`PageElementType`	`PageElementType`	شمارشی از انواع عناصر صفحه.
`PageType`	`PageType`	شمارش انواع صفحات
`ParagraphAlignment`	`ParagraphAlignment`	شمارشی از انواع تراز پاراگراف ها.
`PlaceholderType`	`PlaceholderType`	شمارشی از انواع متغیرها.
`PredefinedLayout`	`PredefinedLayout`	شمارشی از طرح‌بندی‌های از پیش تعریف‌شده.
`SelectionType`	`SelectionType`	شمارشی از انواع انتخاب ها.
`ShapeType`	`ShapeType`	شمارش انواع اشکال
`SheetsChartEmbedType`	`SheetsChartEmbedType`	شمارشی از انواع جاسازی نمودار Sheets.
`SlideLinkingMode`	`SlideLinkingMode`	شمارشی از روش هایی که می توان اسلایدها را پیوند داد.
`SlidePosition`	`SlidePosition`	شمارشی از انواع موقعیت های اسلاید.
`SpacingMode`	`SpacingMode`	شمارشی از انواع حالت های فاصله.
`TextBaselineOffset`	`TextBaselineOffset`	شمارشی از انواع افست خط مبنا متن.
`TextDirection`	`TextDirection`	شمارشی از انواع جهت های متنی.
`ThemeColorType`	`ThemeColorType`	شمارشی از رنگ های تم
`VideoSourceType`	`VideoSourceType`	شمارشی از انواع منبع ویدیویی

مواد و روش ها

روش	نوع برگشت	توضیح مختصر
`create(name)`	`Presentation`	یک `Presentation` جدید ایجاد و باز می کند.
`getActivePresentation()`	`Presentation`	ارائه فعال فعلی را که اسکریپت به آن محدود شده است، برمی‌گرداند، یا اگر ارائه فعالی وجود نداشته باشد، `null` است.
`getUi()`	`Ui`	نمونه‌ای از محیط رابط کاربری ارائه را برمی‌گرداند که به اسکریپت اجازه می‌دهد ویژگی‌هایی مانند منوها، گفتگوها و نوارهای جانبی را اضافه کند.
`newAffineTransformBuilder()`	`AffineTransformBuilder`	یک `AffineTransformBuilder` جدید را برای ساختن `AffineTransform` برمی گرداند.
`openById(id)`	`Presentation`	`Presentation` با شناسه داده شده باز می کند.
`openByUrl(url)`	`Presentation`	`Presentation` را با URL داده شده باز می کند.

مستندات دقیق

`create(name)`

یک Presentation جدید ایجاد و باز می کند.

مولفه های

نام	تایپ کنید	شرح
`name`	`String`	نامی که باید به ارائه ایجاد شده داده شود.

برگشت

Presentation - ارائه با نام داده شده.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

`getActivePresentation()`

ارائه فعال فعلی را که اسکریپت به آن محدود شده است، برمی‌گرداند، یا اگر ارائه فعالی وجود نداشته باشد، null است. برای تعامل با ارائه‌ای که اسکریپت به آن محدود نمی‌شود، به جای آن از openById(id) استفاده کنید.

// Get the current presentation to which this script is bound.
var presentation = SlidesApp.getActivePresentation();

اگر ارائه از قبل باز باشد، همان نمونه ارائه برگردانده می شود.

برگشت

Presentation

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

`getUi()`

نمونه‌ای از محیط رابط کاربری ارائه را برمی‌گرداند که به اسکریپت اجازه می‌دهد ویژگی‌هایی مانند منوها، گفتگوها و نوارهای جانبی را اضافه کند. یک اسکریپت فقط می تواند برای نمونه فعلی یک ارائه باز با رابط کاربری تعامل داشته باشد و تنها در صورتی که اسکریپت به ارائه محدود شده باشد. برای اطلاعات بیشتر، به راهنمای منوها ، گفتگوها و نوارهای جانبی مراجعه کنید.

// Add a custom menu to the active presentation, including a separator and a sub-menu.
function onOpen(e) {
  SlidesApp.getUi()
      .createMenu('My Menu')
      .addItem('My menu item', 'myFunction')
      .addSeparator()
      .addSubMenu(SlidesApp.getUi().createMenu('My sub-menu')
          .addItem('One sub-menu item', 'mySecondFunction')
          .addItem('Another sub-menu item', 'myThirdFunction'))
      .addToUi();
}

برگشت

Ui

`newAffineTransformBuilder()`

یک AffineTransformBuilder جدید را برای ساختن AffineTransform برمی گرداند. سازنده با تبدیل هویت از پیش تنظیم شده است.

برگشت

AffineTransformBuilder

`openById(id)`

Presentation با شناسه داده شده باز می کند.

// Open a presentation by ID.
var presentation = SlidesApp.openById('docId');

اگر ارائه از قبل باز باشد، همان نمونه ارائه برگردانده می شود.

مولفه های

نام	تایپ کنید	شرح
`id`	`String`

برگشت

Presentation - ارائه با شناسه داده شده

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

`openByUrl(url)`

Presentation را با URL داده شده باز می کند.

// Open a presentation by URL.
var presentation = SlidesApp.openByUrl('https://docs.google.com/presentation/d/docId/edit');

اگر ارائه از قبل باز باشد، همان نمونه ارائه برگردانده می شود.

مولفه های

نام	تایپ کنید	شرح
`url`	`String`

برگشت

Presentation - ارائه با URL داده شده

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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