Class Group

گروه

مجموعه‌ای از Page Element که به عنوان یک واحد واحد به هم پیوسته‌اند.

روش‌ها

روش نوع بازگشتی شرح مختصر
align On Page(alignmentPosition) Group عنصر را در موقعیت ترازبندی مشخص شده در صفحه تراز می‌کند.
bring Forward() Group عنصر صفحه را به اندازه یک عنصر به جلو در صفحه می‌آورد.
bring To Front() Group عنصر صفحه را به جلوی صفحه می‌آورد.
duplicate() Page Element عنصر صفحه را کپی می‌کند.
get Children() Page Element[] مجموعه‌ای از عناصر صفحه در گروه را دریافت می‌کند.
get Connection Sites() Connection Site[] لیستی از Connection Site ) را در عنصر صفحه برمی‌گرداند، یا اگر عنصر صفحه هیچ سایت اتصالی نداشته باشد، یک لیست خالی برمی‌گرداند.
get Description() String توضیحات متن جایگزین (alt text) عنصر صفحه را برمی‌گرداند.
get Height() Number|null ارتفاع عنصر را بر حسب نقطه دریافت می‌کند، که برابر با ارتفاع کادر محصورکننده عنصر در زمانی است که عنصر هیچ چرخشی ندارد.
get Inherent Height() Number|null ارتفاع ذاتی عنصر را بر حسب نقطه برمی‌گرداند.
get Inherent Width() Number|null عرض ذاتی عنصر را بر حسب نقطه برمی‌گرداند.
get Left() Number موقعیت افقی عنصر را بر حسب نقطه برمی‌گرداند، که از گوشه بالا سمت چپ صفحه، زمانی که عنصر هیچ چرخشی ندارد، اندازه‌گیری می‌شود.
get Object Id() String شناسه منحصر به فرد این شیء را برمی‌گرداند.
get Page Element Type() Page Element Type نوع عنصر صفحه را برمی‌گرداند، که به صورت یک enum Page Element Type نمایش داده می‌شود.
get Parent Group() Group |null گروهی که این عنصر صفحه به آن تعلق دارد را برمی‌گرداند، یا اگر عنصر در گروهی نباشد null برمی‌گرداند.
get Parent Page() Page صفحه‌ای را که این عنصر صفحه در آن قرار دارد، برمی‌گرداند.
get Rotation() Number زاویه چرخش عنصر در جهت عقربه‌های ساعت حول مرکزش را بر حسب درجه برمی‌گرداند، که در آن صفر درجه به معنای عدم چرخش است.
get Title() String عنوان متن جایگزین (alt text) عنصر صفحه را برمی‌گرداند.
get Top() Number موقعیت عمودی عنصر را بر حسب نقطه دریافت می‌کند، که از گوشه بالا سمت چپ صفحه، زمانی که عنصر هیچ چرخشی ندارد، اندازه‌گیری می‌شود.
get Transform() Affine Transform تبدیل عنصر صفحه را دریافت می‌کند.
get Width() Number|null عرض عنصر را بر حسب نقطه برمی‌گرداند، که برابر با عرض کادر اطراف عنصر است وقتی که عنصر هیچ چرخشی نداشته باشد.
preconcatenate Transform(transform) Group تبدیل ارائه شده را به تبدیل موجود عنصر صفحه از قبل الحاق می‌کند.
remove() void عنصر صفحه را حذف می‌کند.
scale Height(ratio) Group ارتفاع عنصر را با نسبت مشخص شده مقیاس بندی می‌کند.
scale Width(ratio) Group عرض عنصر را با نسبت مشخص شده تغییر می‌دهد.
select() void فقط Page Element در ارائه فعال انتخاب می‌کند و هرگونه انتخاب قبلی را حذف می‌کند.
select(replace) void Page Element در ارائه فعال انتخاب می‌کند.
send Backward() Group عنصر صفحه را به اندازه یک عنصر به عقب در صفحه ارسال می‌کند.
send To Back() Group عنصر صفحه را به پشت صفحه ارسال می‌کند.
set Description(description) Group توضیحات متن جایگزین (alt text) عنصر صفحه را تنظیم می‌کند.
set Height(height) Group ارتفاع عنصر را بر حسب نقطه تنظیم می‌کند، که برابر با ارتفاع کادر اطراف عنصر است وقتی که عنصر هیچ چرخشی ندارد.
set Left(left) Group موقعیت افقی عنصر را بر حسب نقطه تنظیم می‌کند، که از گوشه بالا سمت چپ صفحه، زمانی که عنصر هیچ چرخشی ندارد، اندازه‌گیری می‌شود.
set Rotation(angle) Group زاویه چرخش عنصر را در جهت عقربه‌های ساعت حول مرکز آن بر حسب درجه تنظیم می‌کند.
set Title(title) Group عنوان متن جایگزین (alt text) عنصر صفحه را تنظیم می‌کند.
set Top(top) Group موقعیت عمودی عنصر را بر حسب نقطه تنظیم می‌کند، که از گوشه بالا سمت چپ صفحه، زمانی که عنصر هیچ چرخشی ندارد، اندازه‌گیری می‌شود.
set Transform(transform) Group تبدیل عنصر صفحه را با تبدیل ارائه شده تنظیم می‌کند.
set Width(width) Group عرض عنصر را بر حسب نقطه تنظیم می‌کند، که همان عرض کادر اطراف عنصر است وقتی که عنصر هیچ چرخشی ندارد.
ungroup() void عناصر گروه را از حالت گروه‌بندی خارج می‌کند.

مستندات دقیق

align On Page(alignmentPosition)

عنصر را در موقعیت ترازبندی مشخص شده در صفحه تراز می‌کند.

پارامترها

نام نوع توضیحات
alignment Position Alignment Position موقعیتی که این عنصر صفحه در صفحه با آن ترازبندی می‌شود.

بازگشت

Group - این عنصر صفحه، برای زنجیره‌سازی.

bring Forward()

عنصر صفحه را به اندازه یک عنصر به جلو در صفحه می‌آورد.

عنصر صفحه نباید در یک گروه باشد.

بازگشت

Group - این عنصر صفحه، برای زنجیره‌سازی.

مجوز

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

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

bring To Front()

عنصر صفحه را به جلوی صفحه می‌آورد.

عنصر صفحه نباید در یک گروه باشد.

بازگشت

Group - این عنصر صفحه، برای زنجیره‌سازی.

مجوز

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

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

duplicate()

عنصر صفحه را کپی می‌کند.

عنصر صفحه تکراری در همان صفحه و در همان موقعیت صفحه اصلی قرار می‌گیرد.

بازگشت

Page Element - کپی جدید این عنصر صفحه.

مجوز

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

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

get Children()

مجموعه عناصر صفحه در گروه را دریافت می‌کند. حداقل اندازه یک گروه ۲ است.

بازگشت

Page Element[] — فهرست عناصر صفحه در این گروه.

مجوز

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

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

get Connection Sites()

لیستی از Connection Site ) را در عنصر صفحه برمی‌گرداند، یا اگر عنصر صفحه هیچ سایت اتصالی نداشته باشد، یک لیست خالی برمی‌گرداند.

بازگشت

Connection Site[] — فهرست سایت‌های اتصال، که اگر این عنصر هیچ سایت اتصالی نداشته باشد، ممکن است خالی باشد.

مجوز

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

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

get Description()

توضیحات متن جایگزین (alt text) عنصر صفحه را برمی‌گرداند. این توضیحات با عنوان ترکیب می‌شود تا متن جایگزین نمایش داده شود و خوانده شود.

بازگشت

String - توضیحات متن جایگزین عنصر صفحه.

مجوز

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

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

get Height()

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

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

بازگشت

Number|null — ارتفاع ذاتی عنصر صفحه بر حسب نقطه، یا null اگر عنصر صفحه ارتفاع نداشته باشد.

مجوز

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

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

get Inherent Height()

ارتفاع ذاتی عنصر را بر حسب نقطه برمی‌گرداند.

تبدیل عنصر صفحه نسبت به اندازه ذاتی آن است. از اندازه ذاتی به همراه تبدیل عنصر برای تعیین ظاهر بصری نهایی عنصر استفاده کنید.

بازگشت

Number|null — ارتفاع ذاتی عنصر صفحه بر حسب نقطه، یا null اگر عنصر صفحه ارتفاع نداشته باشد.

مجوز

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

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

get Inherent Width()

عرض ذاتی عنصر را بر حسب نقطه برمی‌گرداند.

تبدیل عنصر صفحه نسبت به اندازه ذاتی آن است. از اندازه ذاتی به همراه تبدیل عنصر برای تعیین ظاهر بصری نهایی عنصر استفاده کنید.

بازگشت

Number|null — عرض ذاتی عنصر صفحه بر حسب نقطه، یا null اگر عنصر صفحه عرض نداشته باشد.

مجوز

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

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

get Left()

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

بازگشت

Number - موقعیت افقی این عنصر بر حسب نقطه، از گوشه بالا سمت چپ صفحه.

مجوز

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

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

get Object Id()

شناسه منحصر به فرد این شیء را برمی‌گرداند. شناسه‌های شیء مورد استفاده توسط صفحات و عناصر صفحه، فضای نام یکسانی را به اشتراک می‌گذارند.

بازگشت

String - شناسه منحصر به فرد برای این شیء.

مجوز

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

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

get Page Element Type()

نوع عنصر صفحه را برمی‌گرداند، که به صورت یک enum Page Element Type نمایش داده می‌شود.

بازگشت

Page Element Type — نوع عنصر صفحه.

مجوز

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

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

get Parent Group()

گروهی که این عنصر صفحه به آن تعلق دارد را برمی‌گرداند، یا اگر عنصر در گروهی نباشد null برمی‌گرداند.

بازگشت

Group |null — گروهی که این عنصر صفحه به آن تعلق دارد، یا null .

مجوز

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

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

get Parent Page()

صفحه‌ای را که این عنصر صفحه در آن قرار دارد، برمی‌گرداند.

بازگشت

Page - صفحه‌ای که این عنصر در آن قرار دارد.

مجوز

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

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

get Rotation()

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

بازگشت

Number — زاویه چرخش بر حسب درجه بین ۰ (شامل) و ۳۶۰ (به‌جز)

مجوز

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

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

get Title()

عنوان متن جایگزین (alt text) عنصر صفحه را برمی‌گرداند. عنوان با توضیحات ترکیب می‌شود تا متن جایگزین نمایش داده شود و خوانده شود.

بازگشت

String - عنوان متن جایگزین عنصر صفحه.

مجوز

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

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

get Top()

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

بازگشت

Number - موقعیت عمودی این عنصر بر حسب نقطه، از گوشه بالا سمت چپ صفحه.

مجوز

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

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

get Transform()

تبدیل عنصر صفحه را دریافت می‌کند.

تبدیل اولیه برای یک Group تازه ایجاد شده همیشه تبدیل همانی است: پارامترهای مقیاس ۱.۰ و پارامترهای برش و انتقال ۰.۰.

بازگشت

Affine Transform - تبدیل عنصر صفحه.

مجوز

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

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

get Width()

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

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

بازگشت

Number|null — عرض ذاتی عنصر صفحه بر حسب نقطه، یا null اگر عنصر صفحه عرض نداشته باشد.

مجوز

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

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

preconcatenate Transform(transform)

تبدیل ارائه شده را به تبدیل موجود عنصر صفحه از قبل الحاق می‌کند.

newTransform = argument * existingTransform;

برای مثال، برای جابجایی عناصر یک صفحه به اندازه ۳۶ نقطه به سمت چپ:

const element = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
element.preconcatenateTransform(
    SlidesApp.newAffineTransformBuilder().setTranslateX(-36.0).build(),
);

همچنین می‌توانید transform عنصر صفحه را با set Transform(transform) جایگزین کنید.

پارامترها

نام نوع توضیحات
transform Affine Transform تبدیلی که قرار است روی تبدیل عنصر این صفحه از پیش الحاق شود.

بازگشت

Group - این عنصر صفحه، برای زنجیره‌سازی.

مجوز

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

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

remove()

عنصر صفحه را حذف می‌کند.

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

اگر یک Page Element جانگهدار (placeholder) در یک صفحه اصلی یا طرح‌بندی حذف شود، هر جانگهدار خالی ارث‌بر نیز حذف می‌شود.

مجوز

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

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

scale Height(ratio)

ارتفاع عنصر را با نسبت مشخص شده مقیاس‌بندی می‌کند. ارتفاع عنصر، ارتفاع کادر اطراف آن است، زمانی که عنصر هیچ چرخشی ندارد.

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

پارامترها

نام نوع توضیحات
ratio Number نسبتی که ارتفاع این عنصر صفحه را بر اساس آن مقیاس‌بندی می‌کند.

بازگشت

Group - این عنصر صفحه، برای زنجیره‌سازی.

مجوز

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

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

scale Width(ratio)

عرض عنصر را با نسبت مشخص شده مقیاس‌بندی می‌کند. عرض عنصر، عرض کادر اطراف آن است، زمانی که عنصر هیچ چرخشی ندارد.

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

پارامترها

نام نوع توضیحات
ratio Number نسبتی که عرض این عنصر صفحه را بر اساس آن مقیاس‌بندی می‌کند.

بازگشت

Group - این عنصر صفحه، برای زنجیره‌سازی.

مجوز

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

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

select()

فقط Page Element در ارائه فعال انتخاب می‌کند و هرگونه انتخاب قبلی را حذف می‌کند. این همان فراخوانی select(replace) با true است.

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

این، Page والد Page Element را به عنوان current page selection تعیین می‌کند.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const pageElement = slide.getPageElements()[0];
// Only select this page element and replace any previous selection.
pageElement.select();

مجوز

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

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

select(replace)

Page Element در ارائه فعال انتخاب می‌کند.

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

برای انتخاب فقط Page Element و حذف هرگونه انتخاب قبلی، مقدار true را به این متد ارسال کنید. این روش همچنین Page والد Page Element را به عنوان current page selection تنظیم می‌کند.

برای انتخاب چندین شیء Page Element مقدار false را ارسال کنید. اشیاء Page Element باید در یک Page باشند.

هنگام انتخاب یک عنصر صفحه با استفاده از پارامتر false ، شرایط زیر باید رعایت شود:

  1. Page والد شیء Page Element باید current page selection باشد.
  2. نباید چندین شیء Page انتخاب شده باشد.

برای اطمینان از این موضوع، رویکرد ترجیحی این است که ابتدا Page والد را با استفاده از Page.selectAsCurrentPage() انتخاب کنید و سپس عناصر صفحه را در آن صفحه انتخاب کنید.

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// First select the slide page, as the current page selection.
slide.selectAsCurrentPage();
// Then select all the page elements in the selected slide page.
const pageElements = slide.getPageElements();
for (let i = 0; i < pageElements.length; i++) {
  pageElements[i].select(false);
}

پارامترها

نام نوع توضیحات
replace Boolean اگر مقدار true ، انتخاب جایگزین هر انتخاب قبلی می‌شود؛ در غیر این صورت، انتخاب به هر انتخاب قبلی اضافه می‌شود.

مجوز

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

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

send Backward()

عنصر صفحه را به اندازه یک عنصر به عقب در صفحه ارسال می‌کند.

عنصر صفحه نباید در یک گروه باشد.

بازگشت

Group - این عنصر صفحه، برای زنجیره‌سازی.

مجوز

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

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

send To Back()

عنصر صفحه را به پشت صفحه ارسال می‌کند.

عنصر صفحه نباید در یک گروه باشد.

بازگشت

Group - این عنصر صفحه، برای زنجیره‌سازی.

مجوز

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

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

set Description(description)

توضیحات متن جایگزین (alt text) عنصر صفحه را تنظیم می‌کند.

این روش برای عناصر Group پشتیبانی نمی‌شود.

// Set the first page element's alt text description to "new alt text
// description".
const pageElement =
    SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setDescription('new alt text description');
Logger.log(pageElement.getDescription());

پارامترها

نام نوع توضیحات
description String رشته‌ای که قرار است توضیحات متن جایگزین روی آن تنظیم شود.

بازگشت

Group — عنصر این صفحه.

مجوز

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

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

set Height(height)

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

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

پارامترها

نام نوع توضیحات
height Number ارتفاع جدید این عنصر صفحه که باید تنظیم شود، بر حسب نقطه.

بازگشت

Group - این عنصر صفحه، برای زنجیره‌سازی.

مجوز

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

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

set Left(left)

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

پارامترها

نام نوع توضیحات
left Number موقعیت افقی جدید برای تنظیم، بر حسب نقطه.

بازگشت

Group - این عنصر صفحه، برای زنجیره‌سازی.

مجوز

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

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

set Rotation(angle)

زاویه چرخش عنصر را در جهت عقربه‌های ساعت حول مرکز آن بر حسب درجه تنظیم می‌کند.

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

پارامترها

نام نوع توضیحات
angle Number زاویه چرخش جدید در جهت عقربه‌های ساعت برای تنظیم، بر حسب درجه.

بازگشت

Group - این عنصر صفحه، برای زنجیره‌سازی.

مجوز

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

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

set Title(title)

عنوان متن جایگزین (alt text) عنصر صفحه را تنظیم می‌کند.

این روش برای عناصر Group پشتیبانی نمی‌شود.

// Set the first page element's alt text title to "new alt text title".
const pageElement =
    SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setTitle('new alt text title');
Logger.log(pageElement.getTitle());

پارامترها

نام نوع توضیحات
title String رشته‌ای که قرار است عنوان متن جایگزین (alt text) روی آن تنظیم شود.

بازگشت

Group — عنصر این صفحه.

مجوز

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

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

set Top(top)

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

پارامترها

نام نوع توضیحات
top Number موقعیت عمودی جدید برای تنظیم، بر حسب نقطه.

بازگشت

Group - این عنصر صفحه، برای زنجیره‌سازی.

مجوز

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

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

set Transform(transform)

تبدیل عنصر صفحه را با تبدیل ارائه شده تنظیم می‌کند.

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

به‌روزرسانی تبدیل یک عنصر صفحه که در یک گروه قرار دارد، فقط تبدیل آن عنصر صفحه را تغییر می‌دهد؛ این کار بر تبدیل‌های گروه یا سایر عناصر صفحه در گروه تأثیری نمی‌گذارد.

برای جزئیات بیشتر در مورد چگونگی تأثیر transformها بر ظاهر بصری عناصر صفحه، به get Transform() مراجعه کنید.

پارامترها

نام نوع توضیحات
transform Affine Transform تبدیلی که برای این عنصر صفحه تنظیم شده است.

بازگشت

Group - این عنصر، برای زنجیره‌سازی.

مجوز

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

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

set Width(width)

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

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

پارامترها

نام نوع توضیحات
width Number عرض جدید این عنصر صفحه که باید تنظیم شود، بر حسب نقطه.

بازگشت

Group - این عنصر صفحه، برای زنجیره‌سازی.

مجوز

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

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

ungroup()

عناصر گروه را از حالت گروه‌بندی خارج می‌کند.

خود گروه حذف می‌شود.

گروه‌هایی که درون گروه‌های دیگر قرار دارند را نمی‌توان از حالت گروه‌بندی خارج کرد.

مجوز

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

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