تصویری را روی شبکه در یک صفحه گسترده نشان می دهد.
مواد و روش ها
روش | نوع برگشت | توضیح مختصر |
---|---|---|
assignScript(functionName) | OverGridImage | تابعی را با نام تابع مشخص شده به این تصویر اختصاص می دهد. |
getAltTextDescription() | String | توضیحات متن جایگزین را برای این تصویر برمی گرداند. |
getAltTextTitle() | String | عنوان متن جایگزین را برای این تصویر برمی گرداند. |
getAnchorCell() | Range | سلولی را که یک تصویر در آن لنگر انداخته است برمی گرداند. |
getAnchorCellXOffset() | Integer | افست پیکسل افقی را از سلول لنگر برمیگرداند. |
getAnchorCellYOffset() | Integer | افست پیکسل عمودی را از سلول لنگر برمیگرداند. |
getHeight() | Integer | ارتفاع واقعی این تصویر را بر حسب پیکسل برمی گرداند. |
getInherentHeight() | Integer | ارتفاع ذاتی این تصویر را بر حسب پیکسل برمی گرداند. |
getInherentWidth() | Integer | ارتفاع ذاتی این تصویر را بر حسب پیکسل برمی گرداند. |
getScript() | String | نام تابع اختصاص داده شده به این تصویر را برمی گرداند. |
getSheet() | Sheet | برگه ای که این تصویر در آن ظاهر می شود را برمی گرداند. |
getUrl() | String | آدرس منبع تصویر را دریافت می کند. اگر URL در دسترس نباشد، null برمی گرداند. |
getWidth() | Integer | عرض واقعی این تصویر را بر حسب پیکسل برمی گرداند. |
remove() | void | این تصویر را از صفحه گسترده حذف می کند. |
replace(blob) | OverGridImage | این تصویر را با تصویر مشخص شده توسط BlobSource ارائه شده جایگزین می کند. |
replace(url) | OverGridImage | این تصویر را با تصویری از URL مشخص شده جایگزین می کند. |
resetSize() | OverGridImage | این تصویر را به ابعاد ذاتی آن بازنشانی می کند. |
setAltTextDescription(description) | OverGridImage | توضیحات متن جایگزین را برای این تصویر تنظیم می کند. |
setAltTextTitle(title) | OverGridImage | عنوان متن جایگزین را برای این تصویر تنظیم می کند. |
setAnchorCell(cell) | OverGridImage | سلولی را که یک تصویر در آن لنگر مییابد تنظیم میکند. |
setAnchorCellXOffset(offset) | OverGridImage | افست پیکسل افقی را از سلول لنگر تنظیم می کند. |
setAnchorCellYOffset(offset) | OverGridImage | افست پیکسل عمودی را از سلول لنگر تنظیم می کند. |
setHeight(height) | OverGridImage | ارتفاع واقعی این تصویر را بر حسب پیکسل تنظیم می کند. |
setWidth(width) | OverGridImage | عرض واقعی این تصویر را بر حسب پیکسل تنظیم می کند. |
مستندات دقیق
assignScript(functionName)
تابعی را با نام تابع مشخص شده به این تصویر اختصاص می دهد.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
functionName | String | نام تابعی که مشخص می شود. این باید یک تابع سطح بالای عمومی باشد، نه تابعی که به زیرخط ختم می شود مانند privateFunction_ . |
برگشت
OverGridImage
- این تصویر برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getAltTextDescription()
توضیحات متن جایگزین را برای این تصویر برمی گرداند.
برگشت
String
- توضیحات متن جایگزین.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getAltTextTitle()
عنوان متن جایگزین را برای این تصویر برمی گرداند.
برگشت
String
- عنوان متن جایگزین.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getAnchorCell()
getAnchorCellXOffset()
افست پیکسل افقی را از سلول لنگر برمیگرداند.
برگشت
Integer
- افست پیکسل افقی.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getAnchorCellYOffset()
افست پیکسل عمودی را از سلول لنگر برمیگرداند.
برگشت
Integer
- افست پیکسل عمودی.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getHeight()
ارتفاع واقعی این تصویر را بر حسب پیکسل برمی گرداند.
// Logs the height of all images in a spreadsheet var images = SpreadsheetApp.getActiveSpreadsheet().getImages(); for (var i = 0; i < images.length; i++) { Logger.log(images[i].getHeight()); }
برگشت
Integer
- ارتفاع تصویر بر حسب پیکسل.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getInherentHeight()
ارتفاع ذاتی این تصویر را بر حسب پیکسل برمی گرداند.
برگشت
Integer
- ارتفاع ذاتی بر حسب پیکسل.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getInherentWidth()
ارتفاع ذاتی این تصویر را بر حسب پیکسل برمی گرداند.
برگشت
Integer
- عرض ذاتی در پیکسل.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getScript()
نام تابع اختصاص داده شده به این تصویر را برمی گرداند.
برگشت
String
- نام تابع.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheet()
برگه ای که این تصویر در آن ظاهر می شود را برمی گرداند.
// Logs the parent sheet of all images in a spreadsheet var images = SpreadsheetApp.getActiveSpreadsheet().getImages(); for (var i = 0; i < images.length; i++) { Logger.log(images[i].getSheet()); }
برگشت
Sheet
- برگه ای که تصویر روی آن ظاهر می شود.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getUrl()
آدرس منبع تصویر را دریافت می کند. اگر URL در دسترس نباشد، null
برمی گرداند. اگر تصویر توسط URL با استفاده از یک API درج شده باشد، این روش URL ارائه شده در هنگام درج تصویر را برمی گرداند.
برگشت
String
- URL تصویر در صورت موجود بودن؛ اگر تصویر در دسترس نباشد یا URL منبع نداشته باشد، null
برمیگرداند.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWidth()
عرض واقعی این تصویر را بر حسب پیکسل برمی گرداند.
// Logs the width of all images in a spreadsheet var images = SpreadsheetApp.getActiveSpreadsheet().getImages(); for (var i = 0; i < images.length; i++) { Logger.log(images[i].getWidth()); }
برگشت
Integer
- عرض تصویر بر حسب پیکسل.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
remove()
این تصویر را از صفحه گسترده حذف می کند. هر گونه عملیات بیشتر روی تصویر منجر به خطای اسکریپت می شود.
// Deletes all images in a spreadsheet var images = SpreadsheetApp.getActiveSpreadsheet().getImages(); for (var i = 0; i < images.length; i++) { images[i].remove(); }
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
replace(blob)
این تصویر را با تصویر مشخص شده توسط BlobSource
ارائه شده جایگزین می کند. حداکثر اندازه حباب پشتیبانی شده 2 مگابایت است.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
blob | BlobSource | تصویر جدید به عنوان یک لکه. |
برگشت
OverGridImage
- این تصویر برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
replace(url)
این تصویر را با تصویری از URL مشخص شده جایگزین می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
url | String | URL تصویر جدید. |
برگشت
OverGridImage
- این تصویر برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
resetSize()
این تصویر را به ابعاد ذاتی آن بازنشانی می کند.
برگشت
OverGridImage
- این تصویر برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setAltTextDescription(description)
توضیحات متن جایگزین را برای این تصویر تنظیم می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
description | String | توضیحات متن جایگزین جدید برای تصویر. |
برگشت
OverGridImage
- این تصویر برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setAltTextTitle(title)
عنوان متن جایگزین را برای این تصویر تنظیم می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
title | String | عنوان متن جایگزین جدید برای تصویر. |
برگشت
OverGridImage
- این تصویر برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setAnchorCell(cell)
سلولی را که یک تصویر در آن لنگر مییابد تنظیم میکند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
cell | Range | سلول لنگر جدید. |
برگشت
OverGridImage
- این تصویر برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setAnchorCellXOffset(offset)
افست پیکسل افقی را از سلول لنگر تنظیم می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
offset | Integer | افست پیکسل افقی جدید. |
برگشت
OverGridImage
- این تصویر برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setAnchorCellYOffset(offset)
افست پیکسل عمودی را از سلول لنگر تنظیم می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
offset | Integer | افست پیکسل عمودی جدید. |
برگشت
OverGridImage
- این تصویر برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setHeight(height)
ارتفاع واقعی این تصویر را بر حسب پیکسل تنظیم می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
height | Integer | ارتفاع مورد نظر بر حسب پیکسل |
برگشت
OverGridImage
- تصویر برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setWidth(width)
عرض واقعی این تصویر را بر حسب پیکسل تنظیم می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
width | Integer | عرض مورد نظر بر حسب پیکسل |
برگشت
OverGridImage
- تصویر برای زنجیر کردن.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets