Class Shape

شکل

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

مواد و روش ها

روش نوع برگشت توضیح مختصر
alignOnPage(alignmentPosition) Shape عنصر را با موقعیت تراز مشخص شده در صفحه تراز می کند.
bringForward() Shape عنصر صفحه را یک عنصر در صفحه جلو می آورد.
bringToFront() Shape عنصر صفحه را به جلوی صفحه می آورد.
duplicate() PageElement عنصر صفحه را کپی می کند.
getAutofit() Autofit Autofit متن را در این شکل برمی‌گرداند.
getBorder() Border Border شکل را برمی گرداند.
getConnectionSites() ConnectionSite[] لیستی از ConnectionSite را در عنصر صفحه برمی‌گرداند، یا اگر عنصر صفحه هیچ سایت اتصالی نداشته باشد، یک لیست خالی را برمی‌گرداند.
getContentAlignment() ContentAlignment ContentAlignment متن را در شکل برمی گرداند.
getDescription() String توضیحات متن جایگزین عنصر صفحه را برمی گرداند.
getFill() Fill Fill شکل را برمی گرداند.
getHeight() Number ارتفاع عنصر را بر حسب نقاط بدست می‌آورد، که در زمانی که عنصر چرخش نداشته باشد، ارتفاع جعبه مرزی عنصر است.
getInherentHeight() Number ارتفاع ذاتی عنصر را بر حسب نقاط برمی‌گرداند.
getInherentWidth() Number عرض ذاتی عنصر را بر حسب نقاط برمی گرداند.
getLeft() Number موقعیت افقی عنصر را در نقاطی که از گوشه سمت چپ بالای صفحه اندازه‌گیری می‌شود، زمانی که عنصر چرخش ندارد، برمی‌گرداند.
getLink() Link اگر پیوندی وجود نداشته باشد، Link برمی‌گرداند یا null .
getObjectId() String شناسه منحصر به فرد این شی را برمی گرداند.
getPageElementType() PageElementType نوع عنصر صفحه را برمی‌گرداند که به صورت یک PageElementType نشان داده می‌شود.
getParentGroup() Group گروهی را که این عنصر صفحه به آن تعلق دارد برمی‌گرداند، یا اگر عنصر در یک گروه نباشد، null برمی‌گرداند.
getParentPage() Page صفحه ای را که این عنصر صفحه در آن است برمی گرداند.
getParentPlaceholder() PageElement عنصر صفحه والد مکان‌نما را برمی‌گرداند.
getPlaceholderIndex() Integer شاخص مکان نگهدار شکل را برمی‌گرداند.
getPlaceholderType() PlaceholderType نوع مکان نگهدار شکل یا PlaceholderType.NONE را برمی‌گرداند اگر شکل مکان‌دار نباشد.
getRotation() Number زاویه چرخش در جهت عقربه‌های ساعت عنصر را در اطراف مرکز آن بر حسب درجه برمی‌گرداند، جایی که صفر درجه به معنای عدم چرخش است.
getShapeType() ShapeType نوع شکل را برمی‌گرداند.
getText() TextRange محتوای متن شکل را برمی‌گرداند.
getTitle() String عنوان متن جایگزین عنصر صفحه را برمی گرداند.
getTop() Number موقعیت عمودی عنصر را در نقاطی که از گوشه سمت چپ بالای صفحه اندازه گیری می شود، زمانی که عنصر چرخش ندارد، می گیرد.
getTransform() AffineTransform تبدیل عنصر صفحه را برمی گرداند.
getWidth() Number عرض عنصر را بر حسب نقاط برمی‌گرداند، که عرض جعبه مرزی عنصر زمانی است که عنصر چرخش نداشته باشد.
preconcatenateTransform(transform) Shape تبدیل ارائه شده را پیش از تبدیل به تبدیل موجود عنصر صفحه پیوند می دهد.
remove() void عنصر صفحه را حذف می کند.
removeLink() void یک Link حذف می کند.
replaceWithImage(blobSource) Image این شکل را با تصویر ارائه شده توسط BlobSource جایگزین می کند.
replaceWithImage(blobSource, crop) Image این شکل را با تصویر ارائه شده توسط BlobSource جایگزین می کند.
replaceWithImage(imageUrl) Image این شکل را با یک تصویر جایگزین می کند.
replaceWithImage(imageUrl, crop) Image این شکل را با یک تصویر جایگزین می کند.
replaceWithSheetsChart(sourceChart) SheetsChart این شکل را با نمودار Google Sheets جایگزین می کند.
replaceWithSheetsChartAsImage(sourceChart) Image این شکل را با تصویری از نمودار Google Sheets جایگزین می‌کند.
scaleHeight(ratio) Shape ارتفاع عنصر را با نسبت مشخص شده مقیاس می کند.
scaleWidth(ratio) Shape عرض عنصر را با نسبت مشخص شده مقیاس می کند.
select() void فقط PageElement در ارائه فعال انتخاب می کند و هر انتخاب قبلی را حذف می کند.
select(replace) void PageElement را در ارائه فعال انتخاب می کند.
sendBackward() Shape عنصر صفحه را یک عنصر به عقب در صفحه می فرستد.
sendToBack() Shape عنصر صفحه را به پشت صفحه می فرستد.
setContentAlignment(contentAlignment) Shape ContentAlignment متن را در شکل تنظیم می کند.
setDescription(description) Shape توضیحات متن جایگزین عنصر صفحه را تنظیم می کند.
setHeight(height) Shape ارتفاع عنصر را بر حسب نقطه تنظیم می‌کند، که ارتفاع جعبه مرزی عنصر در زمانی است که عنصر چرخش نداشته باشد.
setLeft(left) Shape موقعیت افقی عنصر را در نقاطی که از گوشه سمت چپ بالای صفحه اندازه گیری می شود، زمانی که عنصر چرخش ندارد، تنظیم می کند.
setLinkSlide(slideIndex) Link با استفاده از شاخص مبتنی بر صفر Slide ، Link به اسلاید داده شده تنظیم می کند.
setLinkSlide(slide) Link Link به Slide داده شده تنظیم می کند، پیوند توسط شناسه اسلاید داده شده تنظیم می شود.
setLinkSlide(slidePosition) Link با استفاده از موقعیت نسبی اسلاید، Link را به Slide داده شده تنظیم می کند.
setLinkUrl(url) Link یک Link به رشته URL غیر خالی داده شده تنظیم می کند.
setRotation(angle) Shape زاویه چرخش عنصر در جهت عقربه های ساعت را در اطراف مرکز آن بر حسب درجه تنظیم می کند.
setTitle(title) Shape عنوان متن جایگزین عنصر صفحه را تنظیم می کند.
setTop(top) Shape موقعیت عمودی عنصر را در نقاطی که از گوشه سمت چپ بالای صفحه اندازه گیری می شود، زمانی که عنصر چرخش ندارد، تنظیم می کند.
setTransform(transform) Shape تبدیل عنصر صفحه را با تبدیل ارائه شده تنظیم می کند.
setWidth(width) Shape عرض عنصر را بر حسب نقاط تنظیم می کند، که عرض جعبه مرزی عنصر در زمانی است که عنصر چرخش نداشته باشد.

مستندات دقیق

alignOnPage(alignmentPosition)

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

مولفه های

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

برگشت

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

bringForward()

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

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

برگشت

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

مجوز

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

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

bringToFront()

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

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

برگشت

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

مجوز

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

  • 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

getAutofit()

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

برگشت

Autofit - برازش خودکار متن در این شکل.

مجوز

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

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

getBorder()

Border شکل را برمی گرداند.

برگشت

Border - تنظیم حاشیه این شکل.

مجوز

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

  • 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

getContentAlignment()

ContentAlignment متن را در شکل برمی گرداند.

برگشت

ContentAlignment - تراز متن در این شکل.

مجوز

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

  • 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

getFill()

Fill شکل را برمی گرداند.

برگشت

Fill - تنظیم پر کردن این شکل.

مجوز

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

  • 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

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

var link = shape.getLink();
if (link != null) {
  Logger.log('Shape has a link of type: ' + link.getLinkType());
}

برگشت

Link

مجوز

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

  • 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

getParentPlaceholder()

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

برگشت

PageElement - عنصر صفحه والد این null شکل، یا اگر این شکل جای جای نیست یا والد نداشته باشد، تهی است.

مجوز

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

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

getPlaceholderIndex()

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

برگشت

Integer - شاخص مکان نگهدار این شکل، یا اگر شکل یک مکان نگهدار نباشد null .

مجوز

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

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

getPlaceholderType()

نوع مکان نگهدار شکل یا PlaceholderType.NONE را برمی‌گرداند اگر شکل مکان‌دار نباشد.

برگشت

PlaceholderType - نوع مکان نگهدار این شکل.

مجوز

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

  • 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

getShapeType()

نوع شکل را برمی گرداند.

برگشت

ShapeType - نوع این شکل.

getText()

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

متن درون یک شکل همیشه با یک کاراکتر خط جدید خاتمه می یابد.

برگشت

TextRange - محتوای متن این شکل.

مجوز

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

  • 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) جایگزین کنید.

مولفه های

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

برگشت

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

مجوز

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

  • 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

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

shape.removeLink();

replaceWithImage(blobSource)

این شکل را با تصویر ارائه شده توسط BlobSource جایگزین می کند.

تصویر یک بار در زمان درج از BlobSource ارائه شده واکشی می شود و یک کپی برای نمایش در داخل ارائه ذخیره می شود. حجم تصاویر باید کمتر از 50 مگابایت باشد، نباید از 25 مگاپیکسل تجاوز کند و باید با فرمت PNG، JPEG یا GIF باشد.

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

var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
// Get the Drive image file with the given ID.
var driveImage = DriveApp.getFileById(fileId);
shape.replaceWithImage(driveImage);

مولفه های

نام تایپ کنید شرح
blobSource BlobSource داده های تصویر

برگشت

Image - Image که جایگزین شکل شده است.

مجوز

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

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

replaceWithImage(blobSource, crop)

این شکل را با تصویر ارائه شده توسط BlobSource جایگزین می کند.

قرار دادن تصویر یک بار آن را از BlobSource واکشی می کند و یک کپی برای نمایش در داخل ارائه ذخیره می شود. اندازه تصاویر باید کمتر از 50 مگابایت باشد، نباید از 25 مگاپیکسل تجاوز کند و باید در قالب‌های PNG، JPEG یا GIF باشند.

var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
// Get the Drive image file with the given ID.
var driveImage = DriveApp.getFileById(fileId);
// Replace and crop the replaced image.
shape.replaceWithImage(driveImage, true);

مولفه های

نام تایپ کنید شرح
blobSource BlobSource داده های تصویر
crop Boolean اگر true ، تصویر را برش دهید تا متناسب با اندازه شکل موجود باشد. در غیر این صورت، تصویر کوچک شده و در مرکز قرار می گیرد.

برگشت

Image - Image که جایگزین شکل شده است.

مجوز

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

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

replaceWithImage(imageUrl)

این شکل را با یک تصویر جایگزین می کند.

درج تصویر یک بار آن را از URL واکشی می کند و یک کپی برای نمایش در داخل ارائه ذخیره می شود. اندازه تصاویر باید کمتر از 50 مگابایت باشد، نباید از 25 مگاپیکسل تجاوز کند و باید در قالب‌های PNG، JPEG یا GIF باشند.

URL ارائه شده باید برای عموم قابل دسترسی باشد و بزرگتر از 2 کیلوبایت نباشد. خود URL با تصویر ذخیره می شود و از طریق Image.getSourceUrl() در معرض دید قرار می گیرد.

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

مولفه های

نام تایپ کنید شرح
imageUrl String آدرس تصویر برای دانلود تصویر از.

برگشت

Image - Image که جایگزین شکل شده است.

مجوز

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

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

replaceWithImage(imageUrl, crop)

این شکل را با یک تصویر جایگزین می کند.

درج تصویر یک بار آن را از URL واکشی می کند و یک کپی برای نمایش در داخل ارائه ذخیره می شود. اندازه تصاویر باید کمتر از 50 مگابایت باشد، نباید از 25 مگاپیکسل تجاوز کند و باید در قالب‌های PNG، JPEG یا GIF باشند.

URL ارائه شده نباید بزرگتر از 2 کیلوبایت باشد. خود URL با تصویر ذخیره می شود و از طریق Image.getSourceUrl() در معرض دید قرار می گیرد.

مولفه های

نام تایپ کنید شرح
imageUrl String آدرس تصویر برای دانلود تصویر از.
crop Boolean اگر true ، تصویر را برش دهید تا متناسب با اندازه شکل موجود باشد. در غیر این صورت، تصویر کوچک شده و در مرکز قرار می گیرد.

برگشت

Image - Image که جایگزین شکل شده است.

مجوز

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

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

replaceWithSheetsChart(sourceChart)

این شکل را با نمودار Google Sheets جایگزین می کند.

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

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart.
var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
shape.replaceWithSheetsChart(chart);

مولفه های

نام تایپ کنید شرح
sourceChart EmbeddedChart نمودار در یک صفحه گسترده که جایگزین شکل می شود.

برگشت

SheetsChart - نموداری که جایگزین شکل شده است.

مجوز

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

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

replaceWithSheetsChartAsImage(sourceChart)

این شکل را با تصویری از نمودار Google Sheets جایگزین می‌کند.

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

تصویر نمودار با نمودار منبع Google Sheets مرتبط نیست.

var sheet = SpreadsheetApp.openById('spreadsheetId').getSheets()[0];
var chart = sheet.getCharts()[0];
// Replace the shape with the Sheets chart as an image.
var shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
shape.replaceWithSheetsChartAsImage(chart);

مولفه های

نام تایپ کنید شرح
sourceChart EmbeddedChart نمودار در یک صفحه گسترده که جایگزین شکل می شود.

برگشت

Image - تصویر نموداری که جایگزین شکل شده است.

مجوز

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

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

scaleHeight(ratio)

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

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

مولفه های

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

برگشت

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

مجوز

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

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

scaleWidth(ratio)

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

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

مولفه های

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

برگشت

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

مجوز

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

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

مولفه های

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

مجوز

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

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

sendBackward()

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

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

برگشت

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

مجوز

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

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

sendToBack()

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

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

برگشت

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

مجوز

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

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

setContentAlignment(contentAlignment)

ContentAlignment متن را در شکل تنظیم می کند.

این روش به طور خودکار ویژگی های متن را در شکل های به روز شده غیرفعال می کند.

مولفه های

نام تایپ کنید شرح
contentAlignment ContentAlignment تراز برای تنظیم.

برگشت

Shape - این شکل، برای زنجیر زدن.

مجوز

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

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

مولفه های

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

برگشت

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

مجوز

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

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

setHeight(height)

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

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

مولفه های

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

برگشت

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

مجوز

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

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

setLeft(left)

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

مولفه های

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

برگشت

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

مجوز

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

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

setLinkSlide(slideIndex)

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

// Set a link to the first slide of the presentation.
shape.setLinkSlide(0);

مولفه های

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

برگشت

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

مجوز

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

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

setLinkSlide(slide)

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

// Set a link to the first slide of the presentation.
var slide = presentation.getSlides()[0];
shape.setLinkSlide(slide);

مولفه های

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

برگشت

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

مجوز

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

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

setLinkSlide(slidePosition)

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

// Set a link to the first slide of the presentation.
shape.setLinkSlide(SlideApp.SlidePosition.FIRST_SLIDE);

مولفه های

نام تایپ کنید شرح
slidePosition SlidePosition SlidePosition نسبی .

برگشت

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

مجوز

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

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

setLinkUrl(url)

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

// Set a link to the URL.
shape.setLinkUrl("https://slides.google.com");

مولفه های

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

برگشت

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

مجوز

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

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

setRotation(angle)

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

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

مولفه های

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

برگشت

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

مجوز

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

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

مولفه های

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

برگشت

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

مجوز

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

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

setTop(top)

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

مولفه های

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

برگشت

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

مجوز

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

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

setTransform(transform)

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

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

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

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

مولفه های

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

برگشت

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

مجوز

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

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

setWidth(width)

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

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

مولفه های

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

برگشت

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

مجوز

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

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