Class PageElement

PageElement

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

روش ها

روشنوع برگشتشرح مختصر
alignOnPage(alignmentPosition)PageElementعنصر را با موقعیت تراز مشخص شده در صفحه تراز می کند.
asGroup()Groupعنصر صفحه را به صورت گروهی برمی گرداند.
asImage()Imageعنصر صفحه را به صورت تصویر برمی گرداند.
asLine()Lineعنصر صفحه را به صورت یک خط برمی گرداند.
asShape()Shapeعنصر صفحه را به صورت شکل برمی گرداند.
asSheetsChart()SheetsChartعنصر صفحه را به‌عنوان نمودار پیوندی تعبیه‌شده از Google Sheets برمی‌گرداند.
asSpeakerSpotlight()SpeakerSpotlightعنصر صفحه را به عنوان نورافکن بلندگو برمی‌گرداند.
asTable()Tableعنصر صفحه را به صورت جدول برمی گرداند.
asVideo()Videoعنصر صفحه را به صورت ویدیو برمی گرداند.
asWordArt()WordArtعنصر صفحه را به صورت word art برمی گرداند.
bringForward()PageElementعنصر صفحه را یک عنصر در صفحه جلو می آورد.
bringToFront()PageElementعنصر صفحه را به جلوی صفحه می آورد.
duplicate()PageElementعنصر صفحه را کپی می کند.
getConnectionSites()ConnectionSite[]لیستی از ConnectionSite را در عنصر صفحه برمی‌گرداند، یا اگر عنصر صفحه هیچ سایت اتصالی نداشته باشد، یک لیست خالی را برمی‌گرداند.
getDescription()Stringتوضیحات متن جایگزین عنصر صفحه را برمی گرداند.
getHeight()Numberارتفاع عنصر را بر حسب نقاط بدست می‌آورد، که در زمانی که عنصر چرخش نداشته باشد، ارتفاع جعبه مرزی عنصر است.
getInherentHeight()Numberارتفاع ذاتی عنصر را بر حسب نقاط برمی‌گرداند.
getInherentWidth()Numberعرض ذاتی عنصر را بر حسب نقاط برمی گرداند.
getLeft()Numberموقعیت افقی عنصر را در نقاطی که از گوشه سمت چپ بالای صفحه اندازه‌گیری می‌شود، زمانی که عنصر چرخش ندارد، برمی‌گرداند.
getObjectId()Stringشناسه منحصر به فرد این شی را برمی گرداند.
getPageElementType()PageElementTypeنوع عنصر صفحه را برمی‌گرداند که به صورت یک PageElementType نشان داده می‌شود.
getParentGroup()Groupگروهی را که این عنصر صفحه به آن تعلق دارد برمی‌گرداند، یا اگر عنصر در یک گروه نباشد، null برمی‌گرداند.
getParentPage()Pageصفحه ای را که این عنصر صفحه در آن است برمی گرداند.
getRotation()Numberزاویه چرخش در جهت عقربه‌های ساعت عنصر را در اطراف مرکز آن بر حسب درجه برمی‌گرداند، جایی که صفر درجه به معنای عدم چرخش است.
getTitle()Stringعنوان متن جایگزین عنصر صفحه را برمی گرداند.
getTop()Numberموقعیت عمودی عنصر را در نقاطی که از گوشه سمت چپ بالای صفحه اندازه گیری می شود، زمانی که عنصر چرخش ندارد، می گیرد.
getTransform()AffineTransformتبدیل عنصر صفحه را برمی گرداند.
getWidth()Numberعرض عنصر را بر حسب نقاط برمی‌گرداند، که عرض جعبه مرزی عنصر زمانی است که عنصر چرخش نداشته باشد.
preconcatenateTransform(transform)PageElementتبدیل ارائه شده را پیش از تبدیل به تبدیل موجود عنصر صفحه پیوند می دهد.
remove()voidعنصر صفحه را حذف می کند.
scaleHeight(ratio)PageElementارتفاع عنصر را با نسبت مشخص شده مقیاس می کند.
scaleWidth(ratio)PageElementعرض عنصر را با نسبت مشخص شده مقیاس می کند.
select()voidفقط PageElement در ارائه فعال انتخاب می کند و هر انتخاب قبلی را حذف می کند.
select(replace)voidPageElement در ارائه فعال انتخاب می کند.
sendBackward()PageElementعنصر صفحه را یک عنصر به عقب در صفحه می فرستد.
sendToBack()PageElementعنصر صفحه را به پشت صفحه می فرستد.
setDescription(description)PageElementتوضیحات متن جایگزین عنصر صفحه را تنظیم می کند.
setHeight(height)PageElementارتفاع عنصر را بر حسب نقاط تنظیم می کند، که ارتفاع جعبه مرزی عنصر در زمانی است که عنصر چرخش نداشته باشد.
setLeft(left)PageElementموقعیت افقی عنصر را در نقاطی که از گوشه سمت چپ بالای صفحه اندازه گیری می شود، زمانی که عنصر چرخش ندارد، تنظیم می کند.
setRotation(angle)PageElementزاویه چرخش عنصر در جهت عقربه های ساعت را در اطراف مرکز آن بر حسب درجه تنظیم می کند.
setTitle(title)PageElementعنوان متن جایگزین عنصر صفحه را تنظیم می کند.
setTop(top)PageElementموقعیت عمودی عنصر را در نقاطی که از گوشه سمت چپ بالای صفحه اندازه گیری می شود، زمانی که عنصر چرخش ندارد، تنظیم می کند.
setTransform(transform)PageElementتبدیل عنصر صفحه را با تبدیل ارائه شده تنظیم می کند.
setWidth(width)PageElementعرض عنصر را بر حسب نقاط تنظیم می کند، که در زمانی که عنصر فاقد چرخش باشد، عرض جعبه مرزی عنصر است.

مستندات دقیق

alignOnPage(alignmentPosition)

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

پارامترها

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

بازگشت

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

asGroup()

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

بازگشت

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

مجوز

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

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

asImage()

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

بازگشت

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

مجوز

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

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

asLine()

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

بازگشت

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

مجوز

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

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

asShape()

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

بازگشت

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

مجوز

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

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

asSheetsChart()

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

بازگشت

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

مجوز

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

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

asSpeakerSpotlight()

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

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

بازگشت

SpeakerSpotlight - عنصر صفحه به عنوان نورافکن بلندگو.

مجوز

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

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

asTable()

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

بازگشت

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

مجوز

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

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

asVideo()

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

بازگشت

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

مجوز

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

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

asWordArt()

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

بازگشت

WordArt - این عنصر صفحه به عنوان word art.

مجوز

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

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

bringForward()

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

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

بازگشت

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

مجوز

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

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

bringToFront()

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

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

بازگشت

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

مجوز

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

  • 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

getConnectionSites()

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

بازگشت

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

مجوز

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

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

getDescription()

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

بازگشت

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

مجوز

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

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

getHeight()

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

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

بازگشت

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

مجوز

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

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

getInherentHeight()

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

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

بازگشت

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

مجوز

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

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

getInherentWidth()

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

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

بازگشت

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

getObjectId()

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

بازگشت

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

مجوز

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

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

getPageElementType()

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

بازگشت

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

مجوز

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

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

getParentGroup()

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

بازگشت

Group - گروهی که این عنصر صفحه به آن تعلق دارد یا 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 - زاویه چرخش در درجه بین 0 (شامل) و 360 (انحصاری).

مجوز

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

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

getTitle()

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

بازگشت

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 .

مجوز

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

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

preconcatenateTransform(transform)

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

newTransform = argument * existingTransform

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

element.preconcatenateTransform(SlidesApp.newAffineTransformBuilder()
    .setTranslateX(-36.0)
    .build());

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

پارامترها

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

بازگشت

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

مجوز

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

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

remove()

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

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

اگر یک مکان نگهدار PageElement در یک صفحه اصلی یا طرح بندی حذف شود، هر جای جای خالی ارثی نیز حذف می شود.

مجوز

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

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

scaleHeight(ratio)

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

scaleWidth(ratio)

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

select()

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

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

این Page والد PageElement را به عنوان current page selection تنظیم می کند.

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var 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 تنظیم می کند.

Pass false برای انتخاب چندین شیء PageElement . اشیاء PageElement باید در همان Page باشند.

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

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

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

var 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.
var pageElements = slide.getPageElements();
for (var i = 0; i < pageElements.length; i++) {
  pageElements[i].select(false);
}

پارامترها

نامتایپ کنیدتوضیحات
replaceBooleanاگر true ، انتخاب جایگزین هر انتخاب قبلی می شود. در غیر این صورت انتخاب به هر انتخاب قبلی اضافه می شود.

مجوز

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

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

sendBackward()

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

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

بازگشت

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

مجوز

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

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

sendToBack()

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

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

بازگشت

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

مجوز

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

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

setDescription(description)

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

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

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

پارامترها

نامتایپ کنیدتوضیحات
descriptionStringرشته ای برای تنظیم توضیحات متن جایگزین.

بازگشت

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

مجوز

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

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

setHeight(height)

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

setLeft(left)

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

پارامترها

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

بازگشت

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

مجوز

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

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

setRotation(angle)

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

setTitle(title)

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

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

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

پارامترها

نامتایپ کنیدتوضیحات
titleStringرشته ای که عنوان متن جایگزین را روی آن تنظیم کنید.

بازگشت

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

مجوز

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

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

setTop(top)

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

پارامترها

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

بازگشت

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

مجوز

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

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

setTransform(transform)

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

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

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

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

پارامترها

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

بازگشت

PageElement - این عنصر برای زنجیر کردن.

مجوز

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

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

setWidth(width)

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

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

پارامترها

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

بازگشت

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

مجوز

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

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