Class Table

میز

یک PageElement که نشان دهنده یک جدول است.

روش‌ها

روش نوع بازگشتی شرح مختصر
align On Page(alignmentPosition) Table عنصر را در موقعیت ترازبندی مشخص شده در صفحه تراز می‌کند.
append Column() Table Column یک ستون جدید به سمت راست آخرین ستون جدول اضافه می‌کند.
append Row() Table Row یک ردیف جدید زیر آخرین ردیف جدول اضافه می‌کند.
bring Forward() Table عنصر صفحه را به اندازه یک عنصر به جلو در صفحه می‌آورد.
bring To Front() Table عنصر صفحه را به جلوی صفحه می‌آورد.
duplicate() Page Element عنصر صفحه را کپی می‌کند.
get Cell(rowIndex, columnIndex) Table Cell سلول مشخص شده در جدول را برمی‌گرداند.
get Column(columnIndex) Table Column ستون مشخص شده در جدول را برمی‌گرداند.
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 Num Columns() Integer تعداد ستون‌های جدول را برمی‌گرداند.
get Num Rows() Integer تعداد ردیف‌های جدول را برمی‌گرداند.
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 Row(rowIndex) Table Row ردیف مشخص شده در جدول را برمی‌گرداند.
get Title() String عنوان متن جایگزین (alt text) عنصر صفحه را برمی‌گرداند.
get Top() Number موقعیت عمودی عنصر را بر حسب نقطه دریافت می‌کند، که از گوشه بالا سمت چپ صفحه، زمانی که عنصر هیچ چرخشی ندارد، اندازه‌گیری می‌شود.
get Transform() Affine Transform تبدیل عنصر صفحه را برمی‌گرداند.
get Width() Number|null عرض عنصر را بر حسب نقطه برمی‌گرداند، که برابر با عرض کادر اطراف عنصر است وقتی که عنصر هیچ چرخشی نداشته باشد.
insert Column(index) Table Column یک ستون جدید در اندیس مشخص شده از جدول درج می‌کند.
insert Row(index) Table Row یک ردیف جدید در اندیس مشخص شده از جدول درج می‌کند.
preconcatenate Transform(transform) Table تبدیل ارائه شده را به تبدیل موجود عنصر صفحه از قبل الحاق می‌کند.
remove() void عنصر صفحه را حذف می‌کند.
scale Height(ratio) Table ارتفاع عنصر را با نسبت مشخص شده مقیاس بندی می‌کند.
scale Width(ratio) Table عرض عنصر را با نسبت مشخص شده تغییر می‌دهد.
select() void فقط Page Element در ارائه فعال انتخاب می‌کند و هرگونه انتخاب قبلی را حذف می‌کند.
select(replace) void Page Element در ارائه فعال انتخاب می‌کند.
send Backward() Table عنصر صفحه را به اندازه یک عنصر به عقب در صفحه ارسال می‌کند.
send To Back() Table عنصر صفحه را به پشت صفحه ارسال می‌کند.
set Description(description) Table توضیحات متن جایگزین (alt text) عنصر صفحه را تنظیم می‌کند.
set Height(height) Table ارتفاع عنصر را بر حسب نقطه تنظیم می‌کند، که برابر با ارتفاع کادر اطراف عنصر است وقتی که عنصر هیچ چرخشی ندارد.
set Left(left) Table موقعیت افقی عنصر را بر حسب نقطه تنظیم می‌کند، که از گوشه بالا سمت چپ صفحه، زمانی که عنصر هیچ چرخشی ندارد، اندازه‌گیری می‌شود.
set Rotation(angle) Table زاویه چرخش عنصر را در جهت عقربه‌های ساعت حول مرکز آن بر حسب درجه تنظیم می‌کند.
set Title(title) Table عنوان متن جایگزین (alt text) عنصر صفحه را تنظیم می‌کند.
set Top(top) Table موقعیت عمودی عنصر را بر حسب نقطه تنظیم می‌کند، که از گوشه بالا سمت چپ صفحه، زمانی که عنصر هیچ چرخشی ندارد، اندازه‌گیری می‌شود.
set Transform(transform) Table تبدیل عنصر صفحه را با تبدیل ارائه شده تنظیم می‌کند.
set Width(width) Table عرض عنصر را بر حسب نقطه تنظیم می‌کند، که همان عرض کادر اطراف عنصر است وقتی که عنصر هیچ چرخشی ندارد.

مستندات دقیق

alignOnPage(alignmentPosition)

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

پارامترها

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

بازگشت

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

appendColumn()

یک ستون جدید به سمت راست آخرین ستون جدول اضافه می‌کند.

بازگشت

TableColumn — ستون جدید اضافه شده.

مجوز

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

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

appendRow()

یک ردیف جدید زیر آخرین ردیف جدول اضافه می‌کند.

بازگشت

TableRow — ردیف جدید اضافه شده.

مجوز

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

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

bringForward()

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

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

بازگشت

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

مجوز

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

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

bringToFront()

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

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

بازگشت

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

مجوز

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

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

duplicate()

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

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

بازگشت

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

مجوز

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

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

getCell(rowIndex, columnIndex)

سلول مشخص شده در جدول را برمی‌گرداند.

پارامترها

نام نوع توضیحات
row Index Integer اندیس ردیف سلولی که قرار است بازیابی شود.
column Index Integer اندیس ستون سلولی که قرار است بازیابی شود.

بازگشت

TableCell — سلول جدول بازیابی شده.

مجوز

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

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

getColumn(columnIndex)

ستون مشخص شده در جدول را برمی‌گرداند.

پارامترها

نام نوع توضیحات
column Index Integer اندیس ستون مبتنی بر 0.

بازگشت

TableColumn — ستون جدول بازیابی شده.

مجوز

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

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

getConnectionSites()

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

بازگشت

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

مجوز

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

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

getDescription()

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

بازگشت

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

مجوز

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

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

getHeight()

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

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

بازگشت

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

مجوز

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

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

getInherentHeight()

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

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

بازگشت

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

مجوز

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

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

getInherentWidth()

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

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

بازگشت

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

مجوز

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

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

getLeft()

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

بازگشت

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

مجوز

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

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

getNumColumns()

تعداد ستون‌های جدول را برمی‌گرداند.

بازگشت

Integer - تعداد ستون‌های این جدول.

مجوز

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

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

getNumRows()

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

بازگشت

Integer - تعداد ردیف‌های این جدول.

مجوز

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

  • 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

getPageElementType()

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

بازگشت

PageElementType — نوع عنصر صفحه.

مجوز

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

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

getParentGroup()

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

بازگشت

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

مجوز

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

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

getParentPage()

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

بازگشت

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

مجوز

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

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

getRotation()

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

بازگشت

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

مجوز

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

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

getRow(rowIndex)

ردیف مشخص شده در جدول را برمی‌گرداند.

پارامترها

نام نوع توضیحات
row Index Integer اندیس ردیفی که قرار است بازیابی شود.

بازگشت

TableRow - ردیف جدول بازیابی شده.

مجوز

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

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

getTitle()

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

بازگشت

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

مجوز

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

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

getTop()

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

بازگشت

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

مجوز

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

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

getTransform()

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

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

بازگشت

AffineTransform — تبدیل عنصر صفحه.

مجوز

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

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

getWidth()

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

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

بازگشت

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

مجوز

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

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

insertColumn(index)

یک ستون جدید در اندیس مشخص شده از جدول درج می‌کند.

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

پارامترها

نام نوع توضیحات
index Integer اندیسی که قرار است ستون جدید در آن درج شود.

بازگشت

TableColumn — ستون جدید درج شده.

مجوز

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

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

insertRow(index)

یک ردیف جدید در اندیس مشخص شده از جدول درج می‌کند.

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

پارامترها

نام نوع توضیحات
index Integer اندیسی که قرار است سطر جدید در آن درج شود.

بازگشت

TableRow - ردیف جدید درج شده.

مجوز

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

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

preconcatenateTransform(transform)

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

newTransform = argument * existingTransform;

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

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

remove()

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

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

اگر یک placeholder PageElement در یک master یا layout حذف شود، هر placeholder خالیِ به ارث رسیده از آن نیز حذف می‌شود.

مجوز

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

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

scaleHeight(ratio)

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

scaleWidth(ratio)

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

select()

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

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

این، Page والدِ PageElement را به عنوان 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)

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

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

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

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

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

  1. Page والد شیء PageElement باید 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

sendBackward()

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

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

بازگشت

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

مجوز

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

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

sendToBack()

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

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

بازگشت

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

مجوز

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

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

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

بازگشت

Table - عنصر این صفحه.

مجوز

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

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

setHeight(height)

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

setLeft(left)

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

پارامترها

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

بازگشت

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

مجوز

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

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

setRotation(angle)

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

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

بازگشت

Table - عنصر این صفحه.

مجوز

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

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

setTop(top)

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

پارامترها

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

بازگشت

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

مجوز

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

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

setTransform(transform)

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

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

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

setWidth(width)

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

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

پارامترها

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

بازگشت

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

مجوز

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

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