Class PageElement

عنصر صفحه

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

روش‌ها

روش نوع بازگشتی شرح مختصر
align On Page(alignmentPosition) Page Element عنصر را در موقعیت ترازبندی مشخص شده در صفحه تراز می‌کند.
as Group() Group عنصر صفحه را به صورت یک گروه برمی‌گرداند.
as Image() Image عنصر صفحه را به صورت تصویر برمی‌گرداند.
as Line() Line عنصر صفحه را به صورت یک خط برمی‌گرداند.
as Shape() Shape عنصر صفحه را به صورت یک شکل برمی‌گرداند.
as Sheets Chart() Sheets Chart عنصر صفحه را به عنوان یک نمودار پیوندی که از Google Sheets جاسازی شده است، برمی‌گرداند.
as Speaker Spotlight() Speaker Spotlight عنصر صفحه را به عنوان نورافکن بلندگو برمی‌گرداند.
as Table() Table عنصر صفحه را به صورت یک جدول برمی‌گرداند.
as Video() Video عنصر صفحه را به صورت ویدیو برمی‌گرداند.
as Word Art() Word Art عنصر صفحه را به صورت تصویر هنری برمی‌گرداند.
bring Forward() Page Element عنصر صفحه را به اندازه یک عنصر به جلو در صفحه می‌آورد.
bring To Front() Page Element عنصر صفحه را به جلوی صفحه می‌آورد.
duplicate() 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) Page Element تبدیل ارائه شده را به تبدیل موجود عنصر صفحه از قبل الحاق می‌کند.
remove() void عنصر صفحه را حذف می‌کند.
scale Height(ratio) Page Element ارتفاع عنصر را با نسبت مشخص شده مقیاس بندی می‌کند.
scale Width(ratio) Page Element عرض عنصر را با نسبت مشخص شده تغییر می‌دهد.
select() void فقط Page Element در ارائه فعال انتخاب می‌کند و هرگونه انتخاب قبلی را حذف می‌کند.
select(replace) void Page Element در ارائه فعال انتخاب می‌کند.
send Backward() Page Element عنصر صفحه را به اندازه یک عنصر به عقب در صفحه ارسال می‌کند.
send To Back() Page Element عنصر صفحه را به پشت صفحه ارسال می‌کند.
set Description(description) Page Element توضیحات متن جایگزین (alt text) عنصر صفحه را تنظیم می‌کند.
set Height(height) Page Element ارتفاع عنصر را بر حسب نقطه تنظیم می‌کند، که برابر با ارتفاع کادر اطراف عنصر است وقتی که عنصر هیچ چرخشی ندارد.
set Left(left) Page Element موقعیت افقی عنصر را بر حسب نقطه تنظیم می‌کند، که از گوشه بالا سمت چپ صفحه، زمانی که عنصر هیچ چرخشی ندارد، اندازه‌گیری می‌شود.
set Rotation(angle) Page Element زاویه چرخش عنصر را در جهت عقربه‌های ساعت حول مرکز آن بر حسب درجه تنظیم می‌کند.
set Title(title) Page Element عنوان متن جایگزین (alt text) عنصر صفحه را تنظیم می‌کند.
set Top(top) Page Element موقعیت عمودی عنصر را بر حسب نقطه تنظیم می‌کند، که از گوشه بالا سمت چپ صفحه، زمانی که عنصر هیچ چرخشی ندارد، اندازه‌گیری می‌شود.
set Transform(transform) Page Element تبدیل عنصر صفحه را با تبدیل ارائه شده تنظیم می‌کند.
set Width(width) Page Element عرض عنصر را بر حسب نقطه تنظیم می‌کند، که همان عرض کادر اطراف عنصر است وقتی که عنصر هیچ چرخشی ندارد.

مستندات دقیق

align On Page(alignmentPosition)

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

پارامترها

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

بازگشت

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

as Group()

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

بازگشت

Group - این عنصر صفحه به عنوان یک گروه.

مجوز

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

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

as Image()

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

بازگشت

Image — این عنصر صفحه به عنوان یک تصویر.

مجوز

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

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

as Line()

عنصر صفحه را به صورت یک خط برمی‌گرداند.

بازگشت

Line - این عنصر صفحه به عنوان یک خط.

مجوز

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

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

as Shape()

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

بازگشت

Shape - این عنصر صفحه به عنوان یک شکل.

مجوز

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

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

as Sheets Chart()

عنصر صفحه را به عنوان یک نمودار پیوندی که از Google Sheets جاسازی شده است، برمی‌گرداند.

بازگشت

Sheets Chart - عنصر صفحه به عنوان نمودار.

مجوز

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

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

as Speaker Spotlight()

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

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const pageElement = slide.getPageElements()[0];
pageElement.asSpeakerSpotlight();

بازگشت

Speaker Spotlight — عنصر صفحه به عنوان نورافکن بلندگو.

مجوز

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

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

as Table()

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

بازگشت

Table - این عنصر صفحه به عنوان یک جدول.

مجوز

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

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

as Video()

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

بازگشت

Video — این عنصر صفحه به عنوان یک ویدیو.

مجوز

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

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

as Word Art()

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

بازگشت

Word Art - این عنصر صفحه به عنوان هنر کلمه.

مجوز

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

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

bring Forward()

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

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

بازگشت

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

مجوز

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

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

bring To Front()

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

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

بازگشت

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

مجوز

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

  • 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 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()

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

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

بازگشت

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 تبدیلی که قرار است روی تبدیل عنصر این صفحه از پیش الحاق شود.

بازگشت

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

مجوز

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

  • 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 نسبتی که ارتفاع این عنصر صفحه را بر اساس آن مقیاس‌بندی می‌کند.

بازگشت

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

مجوز

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

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

scale Width(ratio)

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

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

پارامترها

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

بازگشت

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

مجوز

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

  • 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()

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

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

بازگشت

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

مجوز

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

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

send To Back()

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

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

بازگشت

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

مجوز

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

  • 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 رشته‌ای که قرار است توضیحات متن جایگزین روی آن تنظیم شود.

بازگشت

Page Element - این عنصر صفحه.

مجوز

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

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

set Height(height)

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

set Left(left)

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

پارامترها

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

بازگشت

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

مجوز

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

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

set Rotation(angle)

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

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

پارامترها

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

بازگشت

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

مجوز

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

  • 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) روی آن تنظیم شود.

بازگشت

Page Element - این عنصر صفحه.

مجوز

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

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

set Top(top)

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

پارامترها

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

بازگشت

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

مجوز

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

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

set Transform(transform)

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

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

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

set Width(width)

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

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

پارامترها

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

بازگشت

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

مجوز

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

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