یک Page Element
که یک تصویر را نشان می دهد.
روش ها
روش | نوع برگشت | شرح مختصر |
---|---|---|
align On Page(alignmentPosition) | Image | عنصر را با موقعیت تراز مشخص شده در صفحه تراز می کند. |
bring Forward() | Image | عنصر صفحه را یک عنصر در صفحه جلو می آورد. |
bring To Front() | Image | عنصر صفحه را به جلوی صفحه می آورد. |
duplicate() | Page Element | عنصر صفحه را کپی می کند. |
get As(contentType) | Blob | داده های داخل این شی را به عنوان یک حباب تبدیل به نوع محتوای مشخص شده برگردانید. |
get Blob() | Blob | داده های داخل این تصویر را به صورت لکه برگردانید. |
get Border() | Border | Border تصویر را برمیگرداند. |
get Connection Sites() | Connection Site[] | لیستی از Connection Site را در عنصر صفحه، یا اگر عنصر صفحه هیچ سایت اتصالی نداشته باشد، یک لیست خالی برمی گرداند. |
get Content Url() | String | یک URL برای تصویر دریافت می کند. |
get Description() | String | توضیحات متن جایگزین عنصر صفحه را برمی گرداند. |
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 Parent Placeholder() | Page Element | عنصر صفحه والد مکاننما را برمیگرداند. |
get Placeholder Index() | Integer | نمایه تصویر مکاننما را برمیگرداند. |
get Placeholder Type() | Placeholder Type | نوع مکاننمای تصویر یا Placeholder Type.NONE را برمیگرداند اگر شکل یک مکاندار نباشد. |
get Rotation() | Number | زاویه چرخش در جهت عقربههای ساعت عنصر را در اطراف مرکز آن بر حسب درجه برمیگرداند، جایی که صفر درجه به معنای عدم چرخش است. |
get Source Url() | String | در صورت موجود بودن، نشانی اینترنتی منبع تصویر را دریافت می کند. |
get Title() | String | عنوان متن جایگزین عنصر صفحه را برمی گرداند. |
get Top() | Number | موقعیت عمودی عنصر را در نقاطی که از گوشه سمت چپ بالای صفحه اندازه گیری می شود، زمانی که عنصر چرخش ندارد، می گیرد. |
get Transform() | Affine Transform | تبدیل عنصر صفحه را برمی گرداند. |
get Width() | Number | عرض عنصر را بر حسب نقاط برمیگرداند، که عرض جعبه مرزی عنصر زمانی است که عنصر چرخش نداشته باشد. |
preconcatenate Transform(transform) | Image | تبدیل ارائه شده را پیش از تبدیل به تبدیل موجود عنصر صفحه پیوند می دهد. |
remove() | void | عنصر صفحه را حذف می کند. |
remove Link() | void | یک Link حذف می کند. |
replace(blobSource) | Image | این تصویر را با یک تصویر توصیف شده توسط یک شی Blob Source جایگزین می کند. |
replace(blobSource, crop) | Image | این تصویر را با تصویری که توسط یک شیء Image توصیف شده است جایگزین میکند، و بهصورت اختیاری تصویر را برش میدهد تا متناسب باشد. |
replace(imageUrl) | Image | این تصویر را با تصویر دیگری که از URL ارائه شده دانلود شده است جایگزین می کند. |
replace(imageUrl, crop) | Image | این تصویر را با تصویر دیگری که از URL ارائه شده دانلود شده است، جایگزین می کند، و به صورت اختیاری تصویر را برش می دهد تا متناسب باشد. |
scale Height(ratio) | Image | ارتفاع عنصر را با نسبت مشخص شده مقیاس می کند. |
scale Width(ratio) | Image | عرض عنصر را با نسبت مشخص شده مقیاس می کند. |
select() | void | فقط Page Element در ارائه فعال انتخاب می کند و هر انتخاب قبلی را حذف می کند. |
select(replace) | void | Page Element در ارائه فعال انتخاب می کند. |
send Backward() | Image | عنصر صفحه را یک عنصر به عقب در صفحه می فرستد. |
send To Back() | Image | عنصر صفحه را به پشت صفحه می فرستد. |
set Description(description) | Image | توضیحات متن جایگزین عنصر صفحه را تنظیم می کند. |
set Height(height) | Image | ارتفاع عنصر را بر حسب نقطه تنظیم میکند، که ارتفاع جعبه مرزی عنصر در زمانی است که عنصر چرخش نداشته باشد. |
set Left(left) | Image | موقعیت افقی عنصر را در نقاطی که از گوشه سمت چپ بالای صفحه اندازه گیری می شود، زمانی که عنصر چرخش ندارد، تنظیم می کند. |
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) | Image | زاویه چرخش عنصر در جهت عقربه های ساعت را در اطراف مرکز آن بر حسب درجه تنظیم می کند. |
set Title(title) | Image | عنوان متن جایگزین عنصر صفحه را تنظیم می کند. |
set Top(top) | Image | موقعیت عمودی عنصر را در نقاطی که از گوشه سمت چپ بالای صفحه اندازه گیری می شود، زمانی که عنصر چرخش ندارد، تنظیم می کند. |
set Transform(transform) | Image | تبدیل عنصر صفحه را با تبدیل ارائه شده تنظیم می کند. |
set Width(width) | Image | عرض عنصر را بر حسب نقاط تنظیم می کند، که عرض جعبه مرزی عنصر در زمانی است که عنصر چرخش نداشته باشد. |
مستندات دقیق
align On Page(alignmentPosition)
عنصر را با موقعیت تراز مشخص شده در صفحه تراز می کند.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
alignment Position | Alignment Position | موقعیتی که این عنصر صفحه را با آن در صفحه تراز می کند. |
بازگشت
Image
- این عنصر صفحه، برای زنجیر کردن.
bring Forward()
عنصر صفحه را یک عنصر در صفحه جلو می آورد.
عنصر صفحه نباید در یک گروه باشد.
بازگشت
Image
- این عنصر صفحه، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
bring To Front()
عنصر صفحه را به جلوی صفحه می آورد.
عنصر صفحه نباید در یک گروه باشد.
بازگشت
Image
- این عنصر صفحه، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
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 As(contentType)
داده های داخل این شی را به عنوان یک حباب تبدیل به نوع محتوای مشخص شده برگردانید. این روش پسوند مناسب را به نام فایل اضافه می کند - به عنوان مثال، "myfile.pdf". با این حال، فرض میکند که بخشی از نام فایل که پس از آخرین نقطه (در صورت وجود) یک پسوند موجود است که باید جایگزین شود. در نتیجه، "ShoppingList.12.25.2014" به "ShoppingList.12.25.pdf" تبدیل می شود.
برای مشاهده سهمیه های روزانه برای تبدیل، به سهمیه خدمات Google مراجعه کنید. دامنههای جدید Google Workspace ممکن است به طور موقت مشمول سهمیههای سختگیرانهتر شوند.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
content Type | String | نوع MIME برای تبدیل. برای اکثر حبابها، 'application/pdf' تنها گزینه معتبر است. برای تصاویر با فرمت BMP، GIF، JPEG یا PNG، هر یک از 'image/bmp' ، 'image/gif' ، 'image/jpeg' یا 'image/png' نیز معتبر هستند. برای سند Google Docs، 'text/markdown' نیز معتبر است. |
بازگشت
Blob
- داده ها به عنوان یک لکه.
get Blob()
get Border()
get Connection Sites()
لیستی از Connection Site
را در عنصر صفحه، یا اگر عنصر صفحه هیچ سایت اتصالی نداشته باشد، یک لیست خالی برمی گرداند.
بازگشت
Connection Site[]
- لیست سایت های اتصال، که اگر این عنصر هیچ سایت اتصالی نداشته باشد، ممکن است خالی باشد.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Content Url()
یک URL برای تصویر دریافت می کند.
این URL با حساب درخواست کننده برچسب گذاری شده است، بنابراین هر کسی که URL را داشته باشد به عنوان درخواست کننده اصلی به تصویر دسترسی پیدا می کند. در صورت تغییر تنظیمات اشتراکگذاری ارائه، ممکن است دسترسی به تصویر از بین برود. URL برگشتی پس از مدت کوتاهی منقضی می شود.
بازگشت
String
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
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 Link()
اگر پیوندی وجود نداشته باشد، 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 Parent Placeholder()
عنصر صفحه والد مکاننما را برمیگرداند. اگر تصویر جایبانی نباشد یا والد نداشته باشد، null
برمیگرداند.
بازگشت
Page Element
- عنصر صفحه اصلی این مکاننمای تصویر، یا اگر این تصویر یک مکاننما نباشد یا والد نداشته باشد، null
.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Placeholder Index()
نمایه تصویر مکاننما را برمیگرداند. اگر دو یا چند تصویر مکاننما در یک صفحه از یک نوع باشند، هر کدام یک مقدار شاخص منحصر به فرد دارند. اگر تصویر جای جای نباشد، null
برمیگرداند.
بازگشت
Integer
- ایندکس مکاننمای این تصویر، یا اگر تصویر جایبانی نباشد، null
.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
get Placeholder Type()
نوع مکاننمای تصویر یا Placeholder Type.NONE
را برمیگرداند اگر شکل یک مکاندار نباشد.
بازگشت
Placeholder Type
- نوع نگهدارنده مکان این تصویر.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
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 Source Url()
در صورت موجود بودن، نشانی اینترنتی منبع تصویر را دریافت می کند.
هنگامی که یک تصویر توسط URL درج می شود، URL ارائه شده در هنگام درج تصویر را برمی گرداند.
بازگشت
String
- URL تصویر یا در صورتی که تصویر دارای URL منبع نباشد، null
.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
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 | تبدیل به پیش الحاق به تبدیل این عنصر صفحه. |
بازگشت
Image
- این عنصر صفحه، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
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
remove Link()
یک Link
حذف می کند.
const slides = SlidesApp.getActivePresentation().getSlides(); slides[1].getShapes()[0].removeLink();
replace(blobSource)
این تصویر را با یک تصویر توصیف شده توسط یک شی Blob Source
جایگزین می کند.
با قرار دادن تصویر یک بار آن را از Blob Source
دریافت می کند و یک کپی برای نمایش در داخل ارائه ذخیره می شود. اندازه تصاویر باید کمتر از 50 مگابایت باشد، نباید از 25 مگاپیکسل تجاوز کند و باید در قالبهای PNG، JPEG یا GIF باشند.
به منظور حفظ نسبت ابعاد تصویر، تصویر با توجه به اندازه تصویر موجود، مقیاس و مرکز می شود.
const image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0]; // Get the Drive image file with the given ID. const driveImage = DriveApp.getFileById("123abc"); image.replace(driveImage);
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
blob Source | Blob Source | داده های تصویر |
بازگشت
Image
- این Image
پس از تعویض.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace(blobSource, crop)
این تصویر را با تصویری که توسط یک شیء Image
توصیف شده است جایگزین میکند، و بهصورت اختیاری تصویر را برش میدهد تا متناسب باشد.
با قرار دادن تصویر یک بار آن را از Blob Source
دریافت می کند و یک کپی برای نمایش در داخل ارائه ذخیره می شود. اندازه تصاویر باید کمتر از 50 مگابایت باشد، نباید از 25 مگاپیکسل تجاوز کند و باید در قالبهای PNG، JPEG یا GIF باشند.
const image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0]; // Get the Drive image file with the given ID. const driveImage = DriveApp.getFileById('123abc'); // Replace and crop the drive image. image.replace(driveImage, true);
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
blob Source | Blob Source | داده های تصویر |
crop | Boolean | اگر true ، تصویر را برش دهید تا متناسب با اندازه تصویر موجود باشد. در غیر این صورت، تصویر کوچک شده و در مرکز قرار می گیرد. |
بازگشت
Image
- این Image
پس از تعویض.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace(imageUrl)
این تصویر را با تصویر دیگری که از URL ارائه شده دانلود شده است جایگزین می کند.
درج تصویر یک بار آن را از URL واکشی می کند و یک کپی برای نمایش در داخل ارائه ذخیره می شود. اندازه تصاویر باید کمتر از 50 مگابایت باشد، نباید از 25 مگاپیکسل تجاوز کند و باید در قالبهای PNG، JPEG یا GIF باشند.
URL ارائه شده باید برای عموم قابل دسترسی باشد و بزرگتر از 2 کیلوبایت نباشد. خود URL با تصویر ذخیره می شود و از طریق get Source Url()
در معرض نمایش قرار می گیرد.
به منظور حفظ نسبت ابعاد تصویر، تصویر با توجه به اندازه تصویر موجود، مقیاس و مرکز می شود.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
image Url | String | URL برای دانلود تصویر از. |
بازگشت
Image
- این Image
پس از تعویض.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replace(imageUrl, crop)
این تصویر را با تصویر دیگری که از URL ارائه شده دانلود شده است، جایگزین می کند، و به صورت اختیاری تصویر را برش می دهد تا متناسب باشد.
درج تصویر یک بار آن را از URL واکشی می کند و یک کپی برای نمایش در داخل ارائه ذخیره می شود. اندازه تصاویر باید کمتر از 50 مگابایت باشد، نباید از 25 مگاپیکسل تجاوز کند و باید در قالبهای PNG، JPEG یا GIF باشند.
URL ارائه شده نباید بزرگتر از 2 کیلوبایت باشد.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
image Url | String | URL برای دانلود تصویر از. |
crop | Boolean | اگر true ، تصویر را برش دهید تا متناسب با اندازه تصویر موجود باشد. در غیر این صورت، تصویر کوچک شده و در مرکز قرار می گیرد. |
بازگشت
Image
- این Image
پس از تعویض.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scale Height(ratio)
ارتفاع عنصر را با نسبت مشخص شده مقیاس می کند. ارتفاع عنصر ارتفاع جعبه مرزی آن است زمانی که عنصر چرخش نداشته باشد.
این روش با همه عناصر صفحه سازگار نیست. برای اطلاع از اینکه کدام عناصر صفحه با این روش سازگار نیستند، به محدودیتهای اندازه و موقعیتیابی مراجعه کنید.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
ratio | Number | نسبت به مقیاس ارتفاع عنصر صفحه بر اساس. |
بازگشت
Image
- این عنصر صفحه، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scale Width(ratio)
عرض عنصر را با نسبت مشخص شده مقیاس می کند. عرض عنصر، عرض جعبه مرزی آن است زمانی که عنصر چرخش نداشته باشد.
این روش با همه عناصر صفحه سازگار نیست. برای اطلاع از اینکه کدام عناصر صفحه با این روش سازگار نیستند، به محدودیتهای اندازه و موقعیتیابی مراجعه کنید.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
ratio | Number | نسبت به مقیاس عرض این عنصر صفحه بر اساس. |
بازگشت
Image
- این عنصر صفحه، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
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
باید شرایط زیر رعایت شود:
-
Page
اصلی شیءPage Element
بایدcurrent page selection
باشد. - نباید چندین شیء
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()
عنصر صفحه را یک عنصر به عقب در صفحه می فرستد.
عنصر صفحه نباید در یک گروه باشد.
بازگشت
Image
- این عنصر صفحه، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
send To Back()
عنصر صفحه را به پشت صفحه می فرستد.
عنصر صفحه نباید در یک گروه باشد.
بازگشت
Image
- این عنصر صفحه، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
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 | رشته ای برای تنظیم توضیحات متن جایگزین. |
بازگشت
Image
- این عنصر صفحه.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Height(height)
ارتفاع عنصر را بر حسب نقطه تنظیم میکند، که ارتفاع جعبه مرزی عنصر در زمانی است که عنصر چرخش نداشته باشد.
این روش با همه عناصر صفحه سازگار نیست. برای اطلاع از اینکه کدام عناصر صفحه با این روش سازگار نیستند، به محدودیتهای اندازه و موقعیتیابی مراجعه کنید.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
height | Number | ارتفاع جدید عنصر صفحه برای تنظیم، بر حسب امتیاز. |
بازگشت
Image
- این عنصر صفحه، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Left(left)
موقعیت افقی عنصر را در نقاطی که از گوشه سمت چپ بالای صفحه اندازه گیری می شود، زمانی که عنصر چرخش ندارد، تنظیم می کند.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
left | Number | موقعیت افقی جدید برای تنظیم، در نقاط. |
بازگشت
Image
- این عنصر صفحه، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
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 | شاخص مبتنی بر صفر به اسلاید. |
بازگشت
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
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 که باید پیوند داده شود. |
بازگشت
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
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 . |
بازگشت
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
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. |
بازگشت
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Rotation(angle)
زاویه چرخش عنصر در جهت عقربه های ساعت را در اطراف مرکز آن بر حسب درجه تنظیم می کند.
این روش با همه عناصر صفحه سازگار نیست. برای اطلاع از اینکه کدام عناصر صفحه با این روش سازگار نیستند، به محدودیتهای اندازه و موقعیتیابی مراجعه کنید.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
angle | Number | تنظیم جدید زاویه چرخش در جهت عقربه های ساعت، بر حسب درجه. |
بازگشت
Image
- این عنصر صفحه، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
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 | رشته ای که باید عنوان متن جایگزین را روی آن تنظیم کنید. |
بازگشت
Image
- این عنصر صفحه.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Top(top)
موقعیت عمودی عنصر را در نقاطی که از گوشه سمت چپ بالای صفحه اندازه گیری می شود، زمانی که عنصر چرخش ندارد، تنظیم می کند.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
top | Number | موقعیت عمودی جدید برای تنظیم، در نقاط. |
بازگشت
Image
- این عنصر صفحه، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Transform(transform)
تبدیل عنصر صفحه را با تبدیل ارائه شده تنظیم می کند.
به روز رسانی تبدیل یک گروه، تبدیل مطلق عناصر صفحه در آن گروه را تغییر می دهد، که می تواند ظاهر بصری آنها را تغییر دهد.
به روز رسانی تبدیل یک عنصر صفحه که در یک گروه است، تنها تبدیل آن عنصر صفحه را تغییر می دهد. بر تبدیل گروه یا سایر عناصر صفحه در گروه تأثیر نمی گذارد.
برای جزئیات بیشتر در مورد اینکه چگونه تبدیل ها بر ظاهر بصری عناصر صفحه تأثیر می گذارند، به get Transform()
مراجعه کنید.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
transform | Affine Transform | تبدیلی که برای این عنصر صفحه تنظیم شده است. |
بازگشت
Image
- این عنصر برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
set Width(width)
عرض عنصر را بر حسب نقاط تنظیم می کند، که عرض جعبه مرزی عنصر در زمانی است که عنصر چرخش نداشته باشد.
این روش با همه عناصر صفحه سازگار نیست. برای اطلاع از اینکه کدام عناصر صفحه با این روش سازگار نیستند، به محدودیتهای اندازه و موقعیتیابی مراجعه کنید.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
width | Number | عرض جدید این عنصر صفحه برای تنظیم، در نقاط. |
بازگشت
Image
- این عنصر صفحه، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations