Class NotesMaster

یادداشت‌ها

استاد یادداشت‌برداری در ارائه.

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

روش‌ها

روش نوع بازگشتی شرح مختصر
get Groups() Group[] لیست اشیاء Group را در صفحه برمی‌گرداند.
get Images() Image[] لیست اشیاء Image موجود در صفحه را برمی‌گرداند.
get Lines() Line[] لیست اشیاء Line را در صفحه برمی‌گرداند.
get Object Id() String شناسه منحصر به فرد صفحه را دریافت می‌کند.
get Page Element By Id(id) Page Element |null Page Element را در صفحه با شناسه داده شده برمی‌گرداند، یا در صورت وجود نداشتن null برمی‌گرداند.
get Page Elements() Page Element[] لیستی از اشیاء Page Element که در صفحه رندر شده‌اند را برمی‌گرداند.
get Placeholder(placeholderType) Page Element |null شیء Page Element جانگهدار را برای یک Placeholder Type مشخص‌شده برمی‌گرداند یا در صورت عدم وجود جانگهدار منطبق، null برمی‌گرداند.
get Placeholder(placeholderType, placeholderIndex) Page Element |null شیء Page Element جانگهدار را برای یک Placeholder Type مشخص شده و یک اندیس جانگهدار برمی‌گرداند، یا در صورت عدم وجود جانگهدار، null را برمی‌گرداند.
get Placeholders() Page Element[] لیستی از اشیاء Page Element که به عنوان placeholder در صفحه قرار دارند را برمی‌گرداند.
get Shapes() Shape[] لیست اشیاء Shape موجود در صفحه را برمی‌گرداند.
get Sheets Charts() Sheets Chart[] لیست اشیاء Sheets Chart را در صفحه برمی‌گرداند.
get Tables() Table[] لیست اشیاء Table موجود در صفحه را برمی‌گرداند.
get Videos() Video[] لیست اشیاء Video ) موجود در صفحه را برمی‌گرداند.
get Word Arts() Word Art[] لیست اشیاء Word Art موجود در صفحه را برمی‌گرداند.

مستندات دقیق

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

getLines()

لیست اشیاء Line را در صفحه برمی‌گرداند.

بازگشت

Line[]

مجوز

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

  • 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 موجود در صفحه با شناسه (ID) داده شده را برمی‌گرداند، یا در صورت وجود نداشتن null برمی‌گرداند.

پارامترها

نام نوع توضیحات
id String شناسه عنصر صفحه‌ای که بازیابی می‌شود.

بازگشت

PageElement |null — عنصر صفحه با شناسه داده شده.

مجوز

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

  • 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

getPlaceholder(placeholderType)

شیء PageElement مربوط به یک PlaceholderType مشخص شده را برمی‌گرداند یا در صورت عدم وجود placeholder منطبق، null برمی‌گرداند.

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

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

پارامترها

نام نوع توضیحات
placeholder Type Placeholder Type نوع متغیری که باید مطابقت داشته باشد.

بازگشت

PageElement |null — عنصر صفحه جای‌نگهدار، یا اگر هیچ موردی یافت نشد، null .

مجوز

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

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

getPlaceholder(placeholderType, placeholderIndex)

شیء PageElement مربوط به یک PlaceholderType و یک اندیس placeholder مشخص شده را برمی‌گرداند، یا در صورت عدم وجود placeholder، null برمی‌گرداند.

اگر چندین متغیر با نوع و اندیس یکسان وجود داشته باشد، اولین متغیر را از مجموعه عناصر صفحه برمی‌گرداند.

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

پارامترها

نام نوع توضیحات
placeholder Type Placeholder Type نوع متغیری که باید مطابقت داشته باشد.
placeholder Index Integer اندیسِ جانگهدار (placeholder) که باید تطبیق داده شود.

بازگشت

PageElement |null — عنصر صفحه جای‌نگهدار، یا اگر هیچ موردی یافت نشد، null .

مجوز

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

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

getPlaceholders()

لیستی از اشیاء PageElement به عنوان placeholder در صفحه قرار دارند را برمی‌گرداند.

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