Class SlidesApp

برنامه اسلایدها

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

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

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

خواص

ملک نوع توضیحات
Alignment Position Alignment Position فهرستی از انواع موقعیت‌های هم‌ترازی.
Arrow Style Arrow Style فهرستی از سبک‌های مختلف فلش که یک Line می‌تواند داشته باشد.
Auto Text Type Auto Text Type فهرستی از انواع متن خودکار.
Autofit Type Autofit Type فهرستی از انواع autofit.
Cell Merge State Cell Merge State شمارشی از حالت‌های مختلف ادغام یک سلول جدول.
Color Type Color Type فهرستی از انواع رنگ.
Content Alignment Content Alignment مجموعه‌ای از مقادیر که برای تعیین ترازبندی محتوا استفاده می‌شوند.
Dash Style Dash Style فهرستی از سبک‌های مختلف خط تیره که یک Line می‌تواند داشته باشد.
Fill Type Fill Type شمارشی از انواع پر کردن.
Line Category Line Category فهرستی از دسته‌های Line .
Line Fill Type Line Fill Type فهرستی از انواع Line Fill .
Line Type Line Type فهرستی از انواع Line .
Link Type Link Type فهرستی از انواع پیوندها
List Preset List Preset فهرستی از انواع پیش‌تنظیم‌های لیست.
Page Background Type Page Background Type فهرستی از انواع پس‌زمینه‌های صفحه.
Page Element Type Page Element Type فهرستی از انواع عناصر صفحه.
Page Type Page Type فهرستی از انواع صفحات.
Paragraph Alignment Paragraph Alignment فهرستی از انواع ترازبندی پاراگراف.
Placeholder Type Placeholder Type فهرستی از انواع متغیرهایی (placeholders).
Predefined Layout Predefined Layout فهرستی از طرح‌بندی‌های از پیش تعریف‌شده.
Selection Type Selection Type فهرستی از انواع انتخاب‌ها
Shape Type Shape Type فهرستی از انواع شکل‌ها.
Sheets Chart Embed Type Sheets Chart Embed Type فهرستی از انواع جاسازی نمودارهای Sheets.
Slide Linking Mode Slide Linking Mode فهرستی از روش‌هایی که می‌توان اسلایدها را به هم مرتبط کرد.
Slide Position Slide Position فهرستی از انواع موقعیت‌های لغزش.
Spacing Mode Spacing Mode فهرستی از انواع حالت‌های فاصله‌گذاری.
Text Baseline Offset Text Baseline Offset فهرستی از انواع انحراف خط پایه متن.
Text Direction Text Direction فهرستی از انواع جهت‌های متنی.
Theme Color Type Theme Color Type فهرستی از رنگ‌های تم.
Video Source Type Video Source Type فهرستی از انواع منابع ویدیویی.

روش‌ها

روش نوع بازگشتی شرح مختصر
create(name) Presentation یک Presentation جدید ایجاد و باز می‌کند.
get Active Presentation() Presentation |null ارائه فعال فعلی که اسکریپت به آن متصل است را برمی‌گرداند، یا اگر ارائه فعالی وجود نداشته باشد null برمی‌گرداند.
get Ui() Ui نمونه‌ای از محیط رابط کاربری ارائه را برمی‌گرداند که به اسکریپت اجازه می‌دهد ویژگی‌هایی مانند منوها، کادرهای محاوره‌ای و نوارهای کناری را اضافه کند.
new Affine Transform Builder() Affine Transform Builder یک Affine Transform Builder جدید برای ساخت یک Affine Transform برمی‌گرداند.
open By Id(id) Presentation Presentation با شناسه (id) داده شده باز می‌کند.
open By Url(url) Presentation Presentation با URL داده شده باز می‌کند.

مستندات دقیق

create(name)

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

پارامترها

نام نوع توضیحات
name String نامی که به ارائه ایجاد شده داده می‌شود.

بازگشت

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

مجوز

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

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

get Active Presentation()

ارائه فعال فعلی که اسکریپت به آن متصل به کانتینر است را برمی‌گرداند، یا اگر هیچ ارائه فعالی وجود نداشته باشد، null برمی‌گرداند. برای تعامل با ارائه‌ای که اسکریپت به آن متصل به کانتینر نیست، به جای آن open By Id(id) استفاده کنید.

// Get the current presentation to which this script is bound.
const presentation = SlidesApp.getActivePresentation();
اگر ارائه از قبل باز باشد، همان نمونه ارائه بازگردانده می‌شود.

بازگشت

Presentation |null

مجوز

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

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

get Ui()

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

// 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

new Affine Transform Builder()

یک Affine Transform Builder جدید برای ساخت یک Affine Transform برمی‌گرداند. سازنده با تبدیل آفین هویت از پیش تنظیم شده است.

بازگشت

Affine Transform Builder

open By Id(id)

Presentation با شناسه (id) داده شده باز می‌کند.

// Open a presentation by ID.
const presentation = SlidesApp.openById('docId');
اگر ارائه از قبل باز باشد، همان نمونه ارائه بازگردانده می‌شود.

پارامترها

نام نوع توضیحات
id String

بازگشت

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

مجوز

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

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

open By Url(url)

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

// Open a presentation by URL.
const presentation = SlidesApp.openByUrl(
    'https://docs.google.com/presentation/d/docId/edit',
);
اگر ارائه از قبل باز باشد، همان نمونه ارائه بازگردانده می‌شود.

پارامترها

نام نوع توضیحات
url String

بازگشت

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

مجوز

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

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