یک PageElement
که یک خط را نشان می دهد.
روش ها
روش | نوع برگشت | شرح مختصر |
---|---|---|
alignOnPage(alignmentPosition) | Line | عنصر را با موقعیت تراز مشخص شده در صفحه تراز می کند. |
bringForward() | Line | عنصر صفحه را یک عنصر در صفحه جلو می آورد. |
bringToFront() | Line | عنصر صفحه را به جلوی صفحه می آورد. |
duplicate() | PageElement | عنصر صفحه را کپی می کند. |
getConnectionSites() | ConnectionSite[] | لیستی از ConnectionSite را در عنصر صفحه برمیگرداند، یا اگر عنصر صفحه هیچ سایت اتصالی نداشته باشد، یک لیست خالی را برمیگرداند. |
getDashStyle() | DashStyle | DashStyle خط را دریافت می کند. |
getDescription() | String | توضیحات متن جایگزین عنصر صفحه را برمی گرداند. |
getEnd() | Point | نقطه پایان خط را که از گوشه سمت چپ بالای صفحه اندازه گیری می شود، برمی گرداند. |
getEndArrow() | ArrowStyle | ArrowStyle فلش در انتهای خط را دریافت می کند. |
getEndConnection() | ConnectionSite | اتصال را در انتهای خط برمیگرداند یا اگر اتصالی وجود نداشته باشد null . |
getHeight() | Number | ارتفاع عنصر را بر حسب نقاط بدست میآورد، که در زمانی که عنصر چرخش نداشته باشد، ارتفاع جعبه مرزی عنصر است. |
getInherentHeight() | Number | ارتفاع ذاتی عنصر را بر حسب نقاط برمیگرداند. |
getInherentWidth() | Number | عرض ذاتی عنصر را بر حسب نقاط برمی گرداند. |
getLeft() | Number | موقعیت افقی عنصر را در نقاطی که از گوشه سمت چپ بالای صفحه اندازهگیری میشود، زمانی که عنصر چرخش ندارد، برمیگرداند. |
getLineCategory() | LineCategory | LineCategory خط را دریافت می کند. |
getLineFill() | LineFill | LineFill خط را دریافت می کند. |
getLineType() | LineType | LineType خط را دریافت می کند. |
getLink() | Link | اگر پیوندی وجود نداشته باشد، Link را برمیگرداند یا null . |
getObjectId() | String | شناسه منحصر به فرد این شی را برمی گرداند. |
getPageElementType() | PageElementType | نوع عنصر صفحه را برمیگرداند که به صورت یک PageElementType نشان داده میشود. |
getParentGroup() | Group | گروهی را که این عنصر صفحه به آن تعلق دارد برمیگرداند، یا اگر عنصر در یک گروه نباشد، null برمیگرداند. |
getParentPage() | Page | صفحه ای را که این عنصر صفحه در آن است برمی گرداند. |
getRotation() | Number | زاویه چرخش در جهت عقربههای ساعت عنصر را در اطراف مرکز آن بر حسب درجه برمیگرداند، جایی که صفر درجه به معنای عدم چرخش است. |
getStart() | Point | نقطه شروع خط را که از گوشه سمت چپ بالای صفحه اندازه گیری می شود، برمی گرداند. |
getStartArrow() | ArrowStyle | ArrowStyle فلش را در ابتدای خط دریافت می کند. |
getStartConnection() | ConnectionSite | اتصال را در ابتدای خط برمیگرداند یا اگر اتصالی وجود نداشته باشد null . |
getTitle() | String | عنوان متن جایگزین عنصر صفحه را برمی گرداند. |
getTop() | Number | موقعیت عمودی عنصر را در نقاطی که از گوشه سمت چپ بالای صفحه اندازه گیری می شود، زمانی که عنصر چرخش ندارد، می گیرد. |
getTransform() | AffineTransform | تبدیل عنصر صفحه را برمی گرداند. |
getWeight() | Number | ضخامت خط را بر حسب نقطه برمی گرداند. |
getWidth() | Number | عرض عنصر را بر حسب نقاط برمیگرداند، که عرض جعبه مرزی عنصر زمانی است که عنصر چرخش نداشته باشد. |
isConnector() | Boolean | اگر خط یک کانکتور باشد، true برمیگرداند، یا اگر نه، false را برمیگرداند. |
preconcatenateTransform(transform) | Line | تبدیل ارائه شده را پیش از تبدیل به تبدیل موجود عنصر صفحه پیوند می دهد. |
remove() | void | عنصر صفحه را حذف می کند. |
removeLink() | void | یک Link حذف می کند. |
reroute() | Line | مسیر شروع و پایان خط را به نزدیکترین دو محل اتصال در عناصر صفحه متصل تغییر می دهد. |
scaleHeight(ratio) | Line | ارتفاع عنصر را با نسبت مشخص شده مقیاس می کند. |
scaleWidth(ratio) | Line | عرض عنصر را با نسبت مشخص شده مقیاس می کند. |
select() | void | فقط PageElement در ارائه فعال انتخاب می کند و هر انتخاب قبلی را حذف می کند. |
select(replace) | void | PageElement در ارائه فعال انتخاب می کند. |
sendBackward() | Line | عنصر صفحه را یک عنصر به عقب در صفحه می فرستد. |
sendToBack() | Line | عنصر صفحه را به پشت صفحه می فرستد. |
setDashStyle(style) | Line | DashStyle خط را تنظیم می کند. |
setDescription(description) | Line | توضیحات متن جایگزین عنصر صفحه را تنظیم می کند. |
setEnd(left, top) | Line | موقعیت نقطه پایانی خط را تعیین می کند. |
setEnd(point) | Line | موقعیت نقطه پایانی خط را تعیین می کند. |
setEndArrow(style) | Line | ArrowStyle فلش را در انتهای خط تنظیم می کند. |
setEndConnection(connectionSite) | Line | اتصال را در انتهای خط تنظیم می کند. |
setHeight(height) | Line | ارتفاع عنصر را بر حسب نقطه تنظیم میکند، که ارتفاع جعبه مرزی عنصر در زمانی است که عنصر چرخش نداشته باشد. |
setLeft(left) | Line | موقعیت افقی عنصر را در نقاطی که از گوشه سمت چپ بالای صفحه اندازه گیری می شود، زمانی که عنصر چرخش ندارد، تنظیم می کند. |
setLineCategory(lineCategory) | Line | LineCategory خط را تنظیم می کند. |
setLinkSlide(slideIndex) | Link | با استفاده از شاخص مبتنی بر صفر اسلاید، Link به Slide داده شده تنظیم می کند. |
setLinkSlide(slide) | Link | Link به Slide داده شده تنظیم می کند، پیوند توسط شناسه اسلاید داده شده تنظیم می شود. |
setLinkSlide(slidePosition) | Link | با استفاده از موقعیت نسبی اسلاید، Link را به Slide داده شده تنظیم می کند. |
setLinkUrl(url) | Link | یک Link به رشته URL غیر خالی داده شده تنظیم می کند. |
setRotation(angle) | Line | زاویه چرخش عنصر در جهت عقربه های ساعت را در اطراف مرکز آن بر حسب درجه تنظیم می کند. |
setStart(left, top) | Line | موقعیت نقطه شروع خط را تعیین می کند. |
setStart(point) | Line | موقعیت نقطه شروع خط را تعیین می کند. |
setStartArrow(style) | Line | ArrowStyle فلش را در ابتدای خط تنظیم می کند. |
setStartConnection(connectionSite) | Line | اتصال را در ابتدای خط تنظیم می کند. |
setTitle(title) | Line | عنوان متن جایگزین عنصر صفحه را تنظیم می کند. |
setTop(top) | Line | موقعیت عمودی عنصر را در نقاطی که از گوشه سمت چپ بالای صفحه اندازه گیری می شود، زمانی که عنصر چرخش ندارد، تنظیم می کند. |
setTransform(transform) | Line | تبدیل عنصر صفحه را با تبدیل ارائه شده تنظیم می کند. |
setWeight(points) | Line | ضخامت خط را بر حسب نقطه تنظیم می کند. |
setWidth(width) | Line | عرض عنصر را بر حسب نقاط تنظیم می کند، که عرض جعبه مرزی عنصر در زمانی است که عنصر چرخش نداشته باشد. |
مستندات دقیق
alignOnPage(alignmentPosition)
عنصر را با موقعیت تراز مشخص شده در صفحه تراز می کند.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
alignmentPosition | AlignmentPosition | موقعیتی که این عنصر صفحه را با آن در صفحه تراز می کند. |
بازگشت
Line
- این عنصر صفحه، برای زنجیر کردن.
bringForward()
عنصر صفحه را یک عنصر در صفحه جلو می آورد.
عنصر صفحه نباید در یک گروه باشد.
بازگشت
Line
- این عنصر صفحه، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
bringToFront()
عنصر صفحه را به جلوی صفحه می آورد.
عنصر صفحه نباید در یک گروه باشد.
بازگشت
Line
- این عنصر صفحه، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
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
getDashStyle()
getDescription()
توضیحات متن جایگزین عنصر صفحه را برمی گرداند. توضیحات برای نمایش و خواندن متن جایگزین با عنوان ترکیب می شود.
بازگشت
String
- توضیحات متن جایگزین عنصر صفحه.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getEnd()
نقطه پایان خط را که از گوشه سمت چپ بالای صفحه اندازه گیری می شود، برمی گرداند.
بازگشت
Point
- نقطه پایان خط.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getEndArrow()
ArrowStyle
فلش در انتهای خط را دریافت می کند.
بازگشت
ArrowStyle
- سبک فلش در انتهای این خط.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getEndConnection()
اتصال را در انتهای خط برمیگرداند یا اگر اتصالی وجود نداشته باشد null
.
بازگشت
ConnectionSite
- اتصال در انتهای خط.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
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
getLineCategory()
LineCategory
خط را دریافت می کند.
بازگشت
LineCategory
- دسته خط.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getLineFill()
getLineType()
getLink()
اگر پیوندی وجود نداشته باشد، Link
را برمیگرداند یا null
.
var link = shape.getLink(); if (link != null) { Logger.log('Shape has a link of type: ' + link.getLinkType()); }
بازگشت
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
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
getStart()
نقطه شروع خط را که از گوشه سمت چپ بالای صفحه اندازه گیری می شود، برمی گرداند.
بازگشت
Point
- نقطه شروع خط.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getStartArrow()
ArrowStyle
فلش را در ابتدای خط دریافت می کند.
بازگشت
ArrowStyle
- سبک فلش در ابتدای این خط.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getStartConnection()
اتصال را در ابتدای خط برمیگرداند یا اگر اتصالی وجود نداشته باشد null
.
بازگشت
ConnectionSite
- اتصال در ابتدای خط.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
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
getWeight()
ضخامت خط را بر حسب نقطه برمی گرداند.
بازگشت
Number
- ضخامت خط در نقاط.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
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
isConnector()
اگر خط یک کانکتور باشد، true
برمیگرداند، یا اگر نه، false
را برمیگرداند.
اتصال دهنده نوعی خط است که برای اتصال سایت های اتصال در عناصر صفحه قابل اجرا استفاده می شود. هر انتهای کانکتور را می توان حداکثر به یک محل اتصال متصل کرد.
بازگشت
Boolean
- اگر خط یک کانکتور باشد True
یا اگر نه false
است.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
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 | تبدیل به پیش الحاق به تبدیل این عنصر صفحه. |
بازگشت
Line
- این عنصر صفحه، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
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
removeLink()
یک Link
حذف می کند.
shape.removeLink();
reroute()
مسیر شروع و پایان خط را به نزدیکترین دو سایت اتصال در عناصر صفحه متصل تغییر می دهد. ابتدا و انتهای خط باید به عناصر مختلف صفحه متصل شود.
بازگشت
Line
- خط.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scaleHeight(ratio)
ارتفاع عنصر را با نسبت مشخص شده مقیاس می کند. ارتفاع عنصر ارتفاع جعبه مرزی آن است زمانی که عنصر چرخش نداشته باشد.
این روش با همه عناصر صفحه سازگار نیست. برای اطلاع از اینکه کدام عناصر صفحه با این روش سازگار نیستند، به محدودیتهای اندازه و موقعیتیابی مراجعه کنید.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
ratio | Number | نسبت به مقیاس ارتفاع عنصر صفحه بر اساس. |
بازگشت
Line
- این عنصر صفحه، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
scaleWidth(ratio)
عرض عنصر را با نسبت مشخص شده مقیاس می کند. عرض عنصر، عرض جعبه مرزی آن است زمانی که عنصر چرخش نداشته باشد.
این روش با همه عناصر صفحه سازگار نیست. برای اطلاع از اینکه کدام عناصر صفحه با این روش سازگار نیستند، به محدودیتهای اندازه و موقعیتیابی مراجعه کنید.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
ratio | Number | نسبت به مقیاس عرض این عنصر صفحه بر اساس. |
بازگشت
Line
- این عنصر صفحه، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
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
باید شرایط زیر رعایت شود:
-
Page
والد شیPageElement
بایدcurrent page selection
باشد. - نباید چندین شیء
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()
عنصر صفحه را یک عنصر به عقب در صفحه می فرستد.
عنصر صفحه نباید در یک گروه باشد.
بازگشت
Line
- این عنصر صفحه، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
sendToBack()
عنصر صفحه را به پشت صفحه می فرستد.
عنصر صفحه نباید در یک گروه باشد.
بازگشت
Line
- این عنصر صفحه، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setDashStyle(style)
DashStyle
خط را تنظیم می کند.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
style | DashStyle | سبک dashing برای ست کردن برای این خط. |
بازگشت
Line
- این خط، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
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 | رشته ای برای تنظیم توضیحات متن جایگزین. |
بازگشت
Line
- این عنصر صفحه.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setEnd(left, top)
موقعیت نقطه پایانی خط را تعیین می کند.
مسیر خط ممکن است پس از تغییر موقعیت تنظیم شود.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
left | Number | موقعیت افقی نقطه پایانی خط، در نقاط از گوشه سمت چپ بالای صفحه اندازه گیری می شود. |
top | Number | موقعیت عمودی نقطه پایانی خط، بر حسب نقاط از گوشه سمت چپ بالای صفحه اندازه گیری می شود. |
بازگشت
Line
- این خط، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setEnd(point)
موقعیت نقطه پایانی خط را تعیین می کند.
مسیر خط ممکن است پس از تغییر موقعیت تنظیم شود.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
point | Point | نقطه پایانی خط که موقعیت آن از گوشه سمت چپ بالای صفحه اندازه گیری می شود. |
بازگشت
Line
- این خط، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setEndArrow(style)
ArrowStyle
فلش را در انتهای خط تنظیم می کند.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
style | ArrowStyle | سبک برای تنظیم. |
بازگشت
Line
- این خط، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setEndConnection(connectionSite)
اتصال را در انتهای خط تنظیم می کند. انتهای خط را به محل اتصال مشخص شده منتقل می کند در حالی که انتهای دیگر را دست نخورده نگه می دارد.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
connectionSite | ConnectionSite | محل اتصال که اتصال پایانی به آن بهروزرسانی میشود، یا در صورت حذف اتصال نهایی null . |
بازگشت
Line
- خط.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setHeight(height)
ارتفاع عنصر را بر حسب نقاط تنظیم می کند، که ارتفاع جعبه مرزی عنصر در زمانی است که عنصر چرخش نداشته باشد.
این روش با همه عناصر صفحه سازگار نیست. برای اطلاع از اینکه کدام عناصر صفحه با این روش سازگار نیستند، به محدودیتهای اندازه و موقعیتیابی مراجعه کنید.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
height | Number | ارتفاع جدید عنصر صفحه برای تنظیم، بر حسب امتیاز. |
بازگشت
Line
- این عنصر صفحه، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLeft(left)
موقعیت افقی عنصر را در نقاطی که از گوشه سمت چپ بالای صفحه اندازه گیری می شود، زمانی که عنصر چرخش ندارد، تنظیم می کند.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
left | Number | موقعیت افقی جدید برای تنظیم، در نقاط. |
بازگشت
Line
- این عنصر صفحه، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLineCategory(lineCategory)
LineCategory
خط را تنظیم می کند.
فقط میتوانید دسته را روی connectors
تنظیم کنید. کانکتور ممکن است پس از تغییر دسته خود تغییر مسیر دهد.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
lineCategory | LineCategory | دسته خط برای تنظیم. |
بازگشت
Line
- خط.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setLinkSlide(slideIndex)
با استفاده از شاخص مبتنی بر صفر اسلاید، Link
به Slide
داده شده تنظیم می کند.
// Set a link to the first slide of the presentation. shape.setLinkSlide(0);
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
slideIndex | Integer | شاخص مبتنی بر صفر به اسلاید. |
بازگشت
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
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 که باید پیوند داده شود. |
بازگشت
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
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 نسبی . |
بازگشت
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
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. |
بازگشت
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setRotation(angle)
زاویه چرخش عنصر در جهت عقربه های ساعت را در اطراف مرکز آن بر حسب درجه تنظیم می کند.
این روش با همه عناصر صفحه سازگار نیست. برای اطلاع از اینکه کدام عناصر صفحه با این روش سازگار نیستند، به محدودیتهای اندازه و موقعیتیابی مراجعه کنید.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
angle | Number | تنظیم جدید زاویه چرخش در جهت عقربه های ساعت، بر حسب درجه. |
بازگشت
Line
- این عنصر صفحه، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setStart(left, top)
موقعیت نقطه شروع خط را تعیین می کند.
مسیر خط ممکن است پس از تغییر موقعیت تنظیم شود.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
left | Number | موقعیت افقی نقطه شروع خط، در نقاط از گوشه سمت چپ بالای صفحه اندازه گیری می شود. |
top | Number | موقعیت عمودی نقطه شروع خط، در نقاطی از گوشه سمت چپ بالای صفحه اندازه گیری می شود. |
بازگشت
Line
- این خط، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setStart(point)
موقعیت نقطه شروع خط را تعیین می کند.
مسیر خط ممکن است پس از تغییر موقعیت تنظیم شود.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
point | Point | نقطه شروع خط که موقعیت آن از گوشه سمت چپ بالای صفحه اندازه گیری می شود. |
بازگشت
Line
- این خط، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setStartArrow(style)
ArrowStyle
فلش را در ابتدای خط تنظیم می کند.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
style | ArrowStyle | سبک جدید برای تنظیم. |
بازگشت
Line
- این خط، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setStartConnection(connectionSite)
اتصال را در ابتدای خط تنظیم می کند. شروع خط را به محل اتصال مشخص شده منتقل می کند در حالی که انتهای دیگر را دست نخورده نگه می دارد.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
connectionSite | ConnectionSite | محل اتصال که اتصال شروع به آن بهروزرسانی میشود، یا در صورت حذف اتصال شروع، null . |
بازگشت
Line
- خط.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
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 | رشته ای که عنوان متن جایگزین را روی آن تنظیم کنید. |
بازگشت
Line
- این عنصر صفحه.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTop(top)
موقعیت عمودی عنصر را در نقاطی که از گوشه سمت چپ بالای صفحه اندازه گیری می شود، زمانی که عنصر چرخش ندارد، تنظیم می کند.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
top | Number | موقعیت عمودی جدید برای تنظیم، در نقاط. |
بازگشت
Line
- این عنصر صفحه، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setTransform(transform)
تبدیل عنصر صفحه را با تبدیل ارائه شده تنظیم می کند.
به روز رسانی تبدیل یک گروه، تبدیل مطلق عناصر صفحه در آن گروه را تغییر می دهد، که می تواند ظاهر بصری آنها را تغییر دهد.
به روز رسانی تبدیل یک عنصر صفحه که در یک گروه است، تنها تبدیل آن عنصر صفحه را تغییر می دهد. بر تبدیل گروه یا سایر عناصر صفحه در گروه تأثیر نمی گذارد.
برای جزئیات بیشتر در مورد اینکه چگونه تبدیل ها بر ظاهر بصری عناصر صفحه تأثیر می گذارند، به getTransform()
مراجعه کنید.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
transform | AffineTransform | تبدیلی که برای این عنصر صفحه تنظیم شده است. |
بازگشت
Line
- این عنصر برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setWeight(points)
ضخامت خط را بر حسب نقطه تنظیم می کند.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
points | Number | ضخامت جدید خط در نقاط. |
بازگشت
Line
- این خط، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setWidth(width)
عرض عنصر را بر حسب نقاط تنظیم می کند، که در زمانی که عنصر فاقد چرخش باشد، عرض جعبه مرزی عنصر است.
این روش با همه عناصر صفحه سازگار نیست. برای اطلاع از اینکه کدام عناصر صفحه با این روش سازگار نیستند، به محدودیتهای اندازه و موقعیتیابی مراجعه کنید.
پارامترها
نام | تایپ کنید | توضیحات |
---|---|---|
width | Number | عرض جدید این عنصر صفحه برای تنظیم، در نقاط. |
بازگشت
Line
- این عنصر صفحه، برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations