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 عنصر صفحه را به صورت word art برمی گرداند.
bring Forward() Page Element عنصر صفحه را یک عنصر در صفحه جلو می آورد.
bring To Front() Page Element عنصر صفحه را به جلوی صفحه می آورد.
duplicate() Page Element عنصر صفحه را کپی می کند.
get Connection Sites() Connection Site[] لیستی از Connection Site را در عنصر صفحه، یا اگر عنصر صفحه هیچ سایت اتصالی نداشته باشد، یک لیست خالی برمی گرداند.
get Description() String توضیحات متن جایگزین عنصر صفحه را برمی گرداند.
get Height() Number ارتفاع عنصر را بر حسب نقاط بدست می‌آورد، که در زمانی که عنصر چرخش نداشته باشد، ارتفاع جعبه مرزی عنصر است.
get Inherent Height() Number ارتفاع ذاتی عنصر را بر حسب نقاط برمی‌گرداند.
get Inherent Width() Number عرض ذاتی عنصر را بر حسب نقاط برمی گرداند.
get Left() Number موقعیت افقی عنصر را در نقاطی که از گوشه سمت چپ بالای صفحه اندازه‌گیری می‌شود، زمانی که عنصر چرخش ندارد، برمی‌گرداند.
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 Title() String عنوان متن جایگزین عنصر صفحه را برمی گرداند.
get Top() Number موقعیت عمودی عنصر را در نقاطی که از گوشه سمت چپ بالای صفحه اندازه گیری می شود، زمانی که عنصر چرخش ندارد، می گیرد.
get Transform() Affine Transform تبدیل عنصر صفحه را برمی گرداند.
get Width() Number عرض عنصر را بر حسب نقاط برمی‌گرداند، که عرض جعبه مرزی عنصر زمانی است که عنصر چرخش نداشته باشد.
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 توضیحات متن جایگزین عنصر صفحه را تنظیم می کند.
set Height(height) Page Element ارتفاع عنصر را بر حسب نقطه تنظیم می‌کند، که ارتفاع جعبه مرزی عنصر در زمانی است که عنصر چرخش نداشته باشد.
set Left(left) Page Element موقعیت افقی عنصر را در نقاطی که از گوشه سمت چپ بالای صفحه اندازه گیری می شود، زمانی که عنصر چرخش ندارد، تنظیم می کند.
set Rotation(angle) Page Element زاویه چرخش عنصر در جهت عقربه های ساعت را در اطراف مرکز آن بر حسب درجه تنظیم می کند.
set Title(title) Page Element عنوان متن جایگزین عنصر صفحه را تنظیم می کند.
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 برمی گرداند.

بازگشت

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

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

بازگشت

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

مجوز

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

  • 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

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

بازگشت

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

مجوز

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

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

remove()

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

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

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

مجوز

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

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

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

این روش برای عناصر 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)

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

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

بازگشت

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)

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

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

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

برای جزئیات بیشتر در مورد اینکه چگونه تبدیل ها بر ظاهر بصری عناصر صفحه تأثیر می گذارند، به 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