تصویری را برای افزودن به یک سلول نشان می دهد. برای افزودن یک تصویر به یک سلول، باید با استفاده از Spreadsheet App.newCellImage() و Cell Image Builder یک مقدار تصویر جدید برای تصویر ایجاد کنید. سپس می توانید از Range.setValue(value) یا Range.setValues(values) برای اضافه کردن مقدار تصویر به سلول استفاده کنید.
خواص
| اموال | تایپ کنید | توضیحات |
|---|---|---|
value Type | Value Type | فیلدی که روی Value Type.IMAGE تنظیم شده است که نشان دهنده نوع مقدار تصویر است. |
روش ها
| روش | نوع برگشت | شرح مختصر |
|---|---|---|
get Alt Text Description() | String | توضیحات متن جایگزین را برای این تصویر برمی گرداند. |
get Alt Text Title() | String | عنوان متن جایگزین را برای این تصویر برمی گرداند. |
get Content Url() | String | URL میزبانی شده توسط Google را به تصویر برمی گرداند. |
get Url() | String | آدرس منبع تصویر را دریافت می کند. اگر URL در دسترس نباشد، null برمی گرداند. |
to Builder() | Cell Image Builder | سازنده ای ایجاد می کند که یک تصویر را به یک نوع مقدار تصویر تبدیل می کند تا بتوانید آن را در یک سلول قرار دهید. |
مستندات دقیق
get Alt Text Description()
توضیحات متن جایگزین را برای این تصویر برمی گرداند.
بازگشت
String - توضیحات متن جایگزین.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
get Alt Text Title()
عنوان متن جایگزین را برای این تصویر برمی گرداند.
بازگشت
String - عنوان متن جایگزین.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
get Content Url()
URL میزبانی شده توسط Google را به تصویر برمی گرداند. این URL با حساب درخواست کننده برچسب گذاری شده است، بنابراین هر کسی که URL را داشته باشد به عنوان درخواست کننده اصلی به تصویر دسترسی پیدا می کند. در صورت تغییر تنظیمات اشتراک‌گذاری صفحه‌گسترده، ممکن است دسترسی به تصویر از بین برود. URL برگشتی پس از مدت کوتاهی منقضی می شود.
بازگشت
String - نشانی اینترنتی تصویر که توسط گوگل میزبانی شده است.
get Url()
آدرس منبع تصویر را دریافت می کند. اگر URL در دسترس نباشد، null برمی گرداند. اگر تصویر توسط URL با استفاده از یک API درج شده باشد، این روش URL ارائه شده در هنگام درج تصویر را برمی گرداند.
بازگشت
String - URL تصویر در صورت موجود بودن؛ اگر تصویر در دسترس نباشد یا URL منبع نداشته باشد null برمی‌گرداند.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
to Builder()
سازنده ای ایجاد می کند که یک تصویر را به یک نوع مقدار تصویر تبدیل می کند تا بتوانید آن را در یک سلول قرار دهید. قبل از اینکه یک تصویر در یک سلول قرار گیرد، باید به عنوان یک نوع مقدار تصویر ایجاد شود. سپس می توانید با استفاده از Range.setValue(value) یا Range.setValues(values) آن را به یک سلول اضافه کنید.
بازگشت
Cell Image Builder - سازنده ای که یک نوع مقدار تصویر را بر اساس ویژگی های تصویر داده شده ایجاد می کند.