Class SheetsChart

نمودار ورق

یک Page Element که نشان دهنده یک نمودار پیوندی است که از Google Sheets تعبیه شده است.

روش ها

روش نوع برگشت شرح مختصر
align On Page(alignmentPosition) Sheets Chart عنصر را با موقعیت تراز مشخص شده در صفحه تراز می کند.
as Image() Image اگر نمودار یک تصویر جاسازی شده نباشد، نمودار را به صورت تصویر یا null برمی‌گرداند.
bring Forward() Sheets Chart عنصر صفحه را یک عنصر در صفحه جلو می آورد.
bring To Front() Sheets Chart عنصر صفحه را به جلوی صفحه می آورد.
duplicate() Page Element عنصر صفحه را کپی می کند.
get Chart Id() Integer شناسه نمودار خاصی را در صفحه‌گسترده Google Sheets که جاسازی شده است، دریافت می‌کند.
get Connection Sites() Connection Site[] لیستی از Connection Site را در عنصر صفحه، یا اگر عنصر صفحه هیچ سایت اتصالی نداشته باشد، یک لیست خالی برمی گرداند.
get Description() String توضیحات متن جایگزین عنصر صفحه را برمی گرداند.
get Embed Type() Sheets Chart Embed Type نوع جاسازی نمودار Sheets را برمی‌گرداند.
get Height() Number ارتفاع عنصر را بر حسب نقاط بدست می‌آورد، که در زمانی که عنصر چرخش نداشته باشد، ارتفاع جعبه مرزی عنصر است.
get Inherent Height() Number ارتفاع ذاتی عنصر را بر حسب نقاط برمی‌گرداند.
get Inherent Width() Number عرض ذاتی عنصر را بر حسب نقاط برمی گرداند.
get Left() Number موقعیت افقی عنصر را در نقاطی که از گوشه سمت چپ بالای صفحه اندازه‌گیری می‌شود، زمانی که عنصر چرخش ندارد، برمی‌گرداند.
get Link() Link اگر پیوندی وجود نداشته باشد، Link برمی‌گرداند یا null .
get Object Id() String شناسه منحصر به فرد این شی را برمی گرداند.
get Page Element Type() Page Element Type نوع عنصر صفحه را برمی‌گرداند که به‌عنوان یک فهرست Page Element Type نمایش داده می‌شود.
get Parent Group() Group گروهی را که این عنصر صفحه به آن تعلق دارد برمی‌گرداند، یا اگر عنصر در یک گروه نباشد null برمی‌گرداند.
get Parent Page() Page صفحه ای را که این عنصر صفحه در آن است برمی گرداند.
get Rotation() Number زاویه چرخش در جهت عقربه‌های ساعت عنصر را در اطراف مرکز آن بر حسب درجه برمی‌گرداند، جایی که صفر درجه به معنای عدم چرخش است.
get Spreadsheet Id() String شناسه صفحه‌گسترده Google Sheets را دریافت می‌کند که حاوی نمودار منبع است.
get Title() String عنوان متن جایگزین عنصر صفحه را برمی گرداند.
get Top() Number موقعیت عمودی عنصر را در نقاطی که از گوشه سمت چپ بالای صفحه اندازه گیری می شود، زمانی که عنصر چرخش ندارد، می گیرد.
get Transform() Affine Transform تبدیل عنصر صفحه را برمی گرداند.
get Width() Number عرض عنصر را بر حسب نقاط برمی‌گرداند، که عرض جعبه مرزی عنصر زمانی است که عنصر چرخش نداشته باشد.
preconcatenate Transform(transform) Sheets Chart تبدیل ارائه شده را پیش از تبدیل به تبدیل موجود عنصر صفحه پیوند می دهد.
refresh() void نمودار را با جایگزین کردن آن با آخرین نسخه نمودار از Google Sheets، تازه می کند.
remove() void عنصر صفحه را حذف می کند.
remove Link() void یک Link حذف می کند.
scale Height(ratio) Sheets Chart ارتفاع عنصر را با نسبت مشخص شده مقیاس می کند.
scale Width(ratio) Sheets Chart عرض عنصر را با نسبت مشخص شده مقیاس می کند.
select() void فقط Page Element در ارائه فعال انتخاب می کند و هر انتخاب قبلی را حذف می کند.
select(replace) void Page Element در ارائه فعال انتخاب می کند.
send Backward() Sheets Chart عنصر صفحه را یک عنصر به عقب در صفحه می فرستد.
send To Back() Sheets Chart عنصر صفحه را به پشت صفحه می فرستد.
set Description(description) Sheets Chart توضیحات متن جایگزین عنصر صفحه را تنظیم می کند.
set Height(height) Sheets Chart ارتفاع عنصر را بر حسب نقطه تنظیم می‌کند، که ارتفاع جعبه مرزی عنصر در زمانی است که عنصر چرخش نداشته باشد.
set Left(left) Sheets Chart موقعیت افقی عنصر را در نقاطی که از گوشه سمت چپ بالای صفحه اندازه گیری می شود، زمانی که عنصر چرخش ندارد، تنظیم می کند.
set Link Slide(slideIndex) Link با استفاده از شاخص مبتنی بر صفر اسلاید، Link را به Slide داده شده تنظیم می کند.
set Link Slide(slide) Link Link را به Slide داده شده تنظیم می کند، پیوند توسط شناسه اسلاید داده شده تنظیم می شود.
set Link Slide(slidePosition) Link با استفاده از موقعیت نسبی اسلاید، Link به Slide داده شده تنظیم می کند.
set Link Url(url) Link یک Link به رشته URL غیر خالی داده شده تنظیم می کند.
set Rotation(angle) Sheets Chart زاویه چرخش عنصر در جهت عقربه های ساعت را در اطراف مرکز آن بر حسب درجه تنظیم می کند.
set Title(title) Sheets Chart عنوان متن جایگزین عنصر صفحه را تنظیم می کند.
set Top(top) Sheets Chart موقعیت عمودی عنصر را در نقاطی که از گوشه سمت چپ بالای صفحه اندازه گیری می شود، زمانی که عنصر چرخش ندارد، تنظیم می کند.
set Transform(transform) Sheets Chart تبدیل عنصر صفحه را با تبدیل ارائه شده تنظیم می کند.
set Width(width) Sheets Chart عرض عنصر را بر حسب نقاط تنظیم می کند، که عرض جعبه مرزی عنصر در زمانی است که عنصر چرخش نداشته باشد.

مستندات دقیق

align On Page(alignmentPosition)

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

پارامترها

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

بازگشت

Sheets Chart - این عنصر صفحه، برای زنجیر کردن.

as Image()

اگر نمودار یک تصویر جاسازی شده نباشد، نمودار را به صورت تصویر یا null برمی‌گرداند.

بازگشت

Image - این نمودار به عنوان یک تصویر، یا اگر نمودار یک تصویر جاسازی شده نباشد، null .

مجوز

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

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

bring Forward()

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

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

بازگشت

Sheets Chart - این عنصر صفحه، برای زنجیر کردن.

مجوز

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

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

bring To Front()

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

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

بازگشت

Sheets Chart - این عنصر صفحه، برای زنجیر کردن.

مجوز

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

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

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

بازگشت

Integer - شناسه نمودار تعبیه شده.

مجوز

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

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

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

بازگشت

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

مجوز

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

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

get Embed Type()

نوع جاسازی نمودار Sheets را برمی‌گرداند.

بازگشت

Sheets Chart Embed Type - نوع جاسازی این نمودار.

مجوز

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

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

get Height()

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

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

بازگشت

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

مجوز

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

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

get Inherent Height()

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

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

بازگشت

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

مجوز

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

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

get Inherent Width()

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

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

بازگشت

Number - عرض ذاتی عنصر صفحه بر حسب نقطه یا اگر عنصر صفحه عرض نداشته باشد، 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

اگر پیوندی وجود نداشته باشد، Link برمی‌گرداند یا null .

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const link = shape.getLink();
if (link != null) {
  Logger.log(`Shape has a link of type: ${link.getLinkType()}`);
}

بازگشت

Link - در صورت عدم وجود پیوند Link یا null .

مجوز

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

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

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

مجوز

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

  • 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 - زاویه چرخش در درجه بین 0 (شامل) و 360 (انحصاری).

مجوز

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

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

get Spreadsheet Id()

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

بازگشت

String - شناسه صفحه گسترده که شامل نمودار منبع است.

مجوز

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

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

get Title()

عنوان متن جایگزین عنصر صفحه را برمی گرداند. عنوان برای نمایش و خواندن متن جایگزین با توضیحات ترکیب شده است.

بازگشت

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 .

مجوز

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

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

preconcatenate Transform(transform)

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

newTransform = argument * existingTransform;

به عنوان مثال، برای انتقال عناصر صفحه 36 نقطه به سمت چپ:

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

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

پارامترها

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

بازگشت

Sheets Chart - این عنصر صفحه، برای زنجیر کردن.

مجوز

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

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

refresh()

نمودار را با جایگزین کردن آن با آخرین نسخه نمودار از Google Sheets، تازه می کند. اگر نمودار از قبل به روز است، هیچ تغییری در نمودار در ارائه ایجاد نکنید.

مجوز

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

  • https://www.googleapis.com/auth/spreadsheets.readonly

remove()

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

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

اگر یک Page Element نگهدارنده روی یک صفحه اصلی یا چیدمان حذف شود، هر جای جای خالی موروثی نیز حذف می شود.

مجوز

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

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

یک Link حذف می کند.

const slides = SlidesApp.getActivePresentation().getSlides();
slides[1].getShapes()[0].removeLink();

scale Height(ratio)

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

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

پارامترها

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

بازگشت

Sheets Chart - این عنصر صفحه، برای زنجیر کردن.

مجوز

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

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

scale Width(ratio)

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

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

پارامترها

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

بازگشت

Sheets Chart - این عنصر صفحه، برای زنجیر کردن.

مجوز

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

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

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

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

بازگشت

Sheets Chart - این عنصر صفحه، برای زنجیر کردن.

مجوز

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

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

send To Back()

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

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

بازگشت

Sheets Chart - این عنصر صفحه، برای زنجیر کردن.

مجوز

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

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

set Description(description)

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

این روش برای عناصر 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 رشته ای برای تنظیم توضیحات متن جایگزین.

بازگشت

Sheets Chart - این عنصر صفحه.

مجوز

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

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

set Height(height)

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

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

پارامترها

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

بازگشت

Sheets Chart - این عنصر صفحه، برای زنجیر کردن.

مجوز

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

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

set Left(left)

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

پارامترها

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

بازگشت

Sheets Chart - این عنصر صفحه، برای زنجیر کردن.

مجوز

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

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

set Link Slide(slideIndex)

با استفاده از شاخص مبتنی بر صفر اسلاید، Link را به Slide داده شده تنظیم می کند.

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(0);

پارامترها

نام تایپ کنید توضیحات
slide Index Integer شاخص مبتنی بر صفر به اسلاید.

بازگشت

Link - Link که تنظیم شده است.

مجوز

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

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

set Link Slide(slide)

Link را به Slide داده شده تنظیم می کند، پیوند توسط شناسه اسلاید داده شده تنظیم می شود.

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(slides[0]);

پارامترها

نام تایپ کنید توضیحات
slide Slide Slide که باید پیوند داده شود.

بازگشت

Link - Link که تنظیم شده است.

مجوز

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

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

set Link Slide(slidePosition)

با استفاده از موقعیت نسبی اسلاید، Link به Slide داده شده تنظیم می کند. 

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);

پارامترها

نام تایپ کنید توضیحات
slide Position Slide Position Slide Position .

بازگشت

Link - Link که تنظیم شده است.

مجوز

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

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

set Link Url(url)

یک Link به رشته URL غیر خالی داده شده تنظیم می کند. 

// Set a link to the URL.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkUrl('https://slides.google.com');

پارامترها

نام تایپ کنید توضیحات
url String رشته URL.

بازگشت

Link - Link که تنظیم شده است.

مجوز

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

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

set Rotation(angle)

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

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

پارامترها

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

بازگشت

Sheets Chart - این عنصر صفحه، برای زنجیر کردن.

مجوز

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

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

set Title(title)

عنوان متن جایگزین عنصر صفحه را تنظیم می کند.

این روش برای عناصر 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 رشته ای که عنوان متن جایگزین را روی آن تنظیم کنید.

بازگشت

Sheets Chart - این عنصر صفحه.

مجوز

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

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

set Top(top)

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

پارامترها

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

بازگشت

Sheets Chart - این عنصر صفحه، برای زنجیر کردن.

مجوز

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

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

set Transform(transform)

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

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

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

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

پارامترها

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

بازگشت

Sheets Chart - این عنصر، برای زنجیر.

مجوز

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

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

set Width(width)

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

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

پارامترها

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

بازگشت

Sheets Chart - این عنصر صفحه، برای زنجیر کردن.

مجوز

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

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